Some work steps require access to the RevPi base module directly via a terminal.

✓ There is a network connection between the RevPi and your PC.

Establishing SSH Connection via Terminal #

✓ The SSH deamon must be enabled.

▷ Open a terminal on your PC, e.g. Windows 10/11 command prompt, PowerShell, Linux terminal.

▷ Establish an SSH connection with the command ssh pi@revpi[serial number].local.
You can find the serial number on the front of the housing.
Alternatively, you can use ssh pi@[IP address] if the connection via .local does not work, see Avahi (ZeroConf).

▷ Log in with user name pi and the device password.
You can find the device password on the sticker on the side of the RevPi housing.

When you log in for the first time, you will be asked to create your own password.

Using SSH Client #

✓ The SSH deamon must be enabled.

The connection to the RevPi can be established via an SSH client.

▷ Install and open an SSH client on your PC, e.g. PuTTY, OpenSSh.

▷ Enter the parameters for the SSH connection:

▷ Start the SSH connection.

❯ An SSH terminal opens.

▷ Log in with user name pi and the password.

Rebooting RevPi via Terminal #

Important
Damage to the device software due to disconnection from the power supply

If the device is disconnected from the power supply during operation, the file system of the eMMC memory may be destroyed. The device can then no longer be booted.

▷ Shut down the device properly before disconnecting it from the power supply.

▷ Log in to the RevPi via a terminal.

▷ Enter the following command:

sudo reboot
Note

From the RevPi Bookworm (08/2025), users need to enter their password when executing commands with sudo.

❯ The RevPi restarts.

▷ Log in with user name pi and the password.

Alternatively, you can reboot the RevPi via Cockpit.

Shutting Down RevPi via Terminal #

Important
Damage to the device software due to disconnection from the power supply

If the device is disconnected from the power supply during operation, the file system of the eMMC memory may be destroyed. The device can then no longer be booted.

▷ Shut down the device properly before disconnecting it from the power supply.

▷ Log in to the RevPi via a terminal.

▷ Enter the following command:

sudo shutdown
Note

From the RevPi Bookworm (08/2025), users need to enter their password when executing commands with sudo.

❯❯ The RevPi shuts down.

Note

To restart the RevPi after a shutdown, the power supply must be disconnected and reconnected.

Alternatively, you can shutdown the RevPi via Cockpit.

Installing Updates #

Important

▷ Check at regular intervals whether updates are available.

▷ Install updates promptly to close security gaps.

▷ Log in to the RevPi via a terminal.

▷ Enter the following command to read and update all available package lists:

sudo apt update
Note

From the RevPi Bookworm (08/2025), users need to enter their password when executing commands with sudo.

▷ Enter the following command to install all available updates:

sudo apt full-upgrade

▷ Enter the following command to restart the RevPi:

sudo reboot

Alternatively, you can install updates directly via Cockpit.

Installing or Removing a Single Package #

▷ Log in to the RevPi via a terminal.

▷ Enter the following command to update all package lists:

sudo apt update
Note

From the RevPi Bookworm (08/2025), users need to enter their password when executing commands with sudo.

▷ Enter the following command to install a new package:

sudo apt install packagename

▷ Enter the following command to remove a package:

sudo apt remove packagename

▷ Enter the following command to restart the RevPi:

sudo reboot

Changing Password #

Important

▷ Change the initial device password after the first login to prevent unauthorized access.

▷ Use a strong password.

▷ Log in to the RevPi via a terminal.

▷ Enter the command passwd and confirm with Enter.

▷ Enter the current password.

▷ Enter the new password twice and confirm each time with Enter.
The password is not displayed under Linux.

❯❯ Password updated successfully appears in the terminal. The password for user pi is changed.

Alternatively, you can use the Password Management in Cockpit to change the password.

Further Resources #