Step 2 of 8

Connect to the computer

This step explains how to open the terminal of the BiblioViva computer, the window in which the commands of the following steps are typed. It takes about 10 minutes. A terminal is a text window in which a command is written and the computer's answer is read.

Raspberry Pi with Tailscale

Requirements

Another computer (Windows, macOS or Linux) connected to the same network as the Raspberry Pi.
The user name and the password written down in the step Prepare the computer.

Procedure

The Raspberry Pi has no keyboard or screen: it is controlled from another computer with SSH, a program that connects the two computers through the network. SSH is already present in Windows 10 and 11, in macOS and in Linux (official guide).

On the other computer, open the terminal.
- In Windows: open the Start menu, type "PowerShell" and open the program (in Windows 11 "Terminal" will also do).
- In macOS: open "Terminal" from the Utilities folder of Applications.
- In Linux: open "Terminal" from the applications menu (usually also with Ctrl+Alt+T).
Type the following command, replacing <user> with the user name written down, and press Enter.
```
ssh <user>@biblioviva.local
```

At the first connection the terminal shows a question about the fingerprint of the computer's key. Answer yes and press Enter. The question appears only the first time.

The authenticity of host 'biblioviva.local (192.168.1.50)' can't be established.
ED25519 key fingerprint is SHA256:...
Are you sure you want to continue connecting (yes/no/[fingerprint])?

Type the password written down and press Enter. While the password is typed nothing appears, not even asterisks: this is normal.
If the name biblioviva.local does not answer, look for the Raspberry Pi's address in the router's list of devices (for example 192.168.1.50) and use it in place of the name.
```
ssh <user>@<address>
```

Copy and paste a command

The following steps give commands to copy. To run one:

Select the command on the page and copy it (Ctrl+C; in macOS Cmd+C).
Switch to the terminal window and paste it.
- In the Linux terminal: Ctrl+Shift+V.
- In the Windows Terminal: right-click in the window, or Ctrl+Shift+V.
- In the macOS Terminal: Cmd+V.
Press Enter to run the command.

Check before going on

The terminal shows a line that ends with the prompt symbol ($) and begins with the user name, the at sign and the computer's name:

<user>@biblioviva:~ $

The terminal is ready: the commands of the following steps are pasted here. When the line does not appear, see "Possible problems".

Possible problems

"Connection refused": the PC or the Raspberry Pi is not ready yet, or SSH is not active. Wait a few minutes and try again. If the message stays, for the PC install the SSH server (sudo apt install -y openssh-server); for the Raspberry Pi repeat the writing of the card turning on SSH.
"Permission denied, please try again" (wrong password): type the password again with care, paying attention to the keyboard layout (capitals, symbols). After three failed attempts the program stops: repeat the command.
"Could not resolve hostname biblioviva.local" (name not found): the computer does not answer to the name. Check that it is on and connected to the same network, then use the address the router shows.
"Connection timed out": the address is not the computer's or the computer cannot be reached. Check the address in the router's list.
"REMOTE HOST IDENTIFICATION HAS CHANGED": the Raspberry Pi's card was rewritten and the name is already known with another key. Delete the old key with the following command and repeat the connection.
```
ssh-keygen -R biblioviva.local
```

Connect to the computer

Procedure

Copy and paste a command

Possible problems

Related pages