Skip to main content

SSH access on volumio

Volumio supports command-line access via SSH. This can be helpful if you need full access to the device, for example if you are debugging a problem or want to test changes to the system.

Most popular operating systems support making SSH connections in some way:

  • Windows : Install Putty, or use ssh.exe on Windows 10

  • Linux : ssh command from a terminal

  • macOS : ssh command from the Terminal app (You may need to install openssh first)

Once you have enabled SSH access (see below), you can log in with:

  • user: volumio

  • password: volumio

Example (Linux) :

laptop$ ssh volumio@192.168.1.80
volumio@192.168.1.80 password:

Type in the password at the prompt and press the <Enter> key. (The password will not be shown on the screen)

And here you are !

volumio@192.168.1.80's password:
___
/\_ \ __
__ __ ___\//\ \ __ __ ___ ___ /\_\ ___
/\ \/\ \ / __`\\ \ \ /\ \/\ \ /' __` __`\/\ \ / __`\
\ \ \_/ |/\ \L\ \\_\ \_\ \ \_\ \/\ \/\ \/\ \ \ \/\ \L\ \
\ \___/ \ \____//\____\\ \____/\ \_\ \_\ \_\ \_\ \____/
\/__/ \/___/ \/____/ \/___/ \/_/\/_/\/_/\/_/\/___/

Free Audiophile Linux Music Player - Version 3.0

© 2015-2021 Michelangelo Guarise - Volumio Team - Volumio.org

Volumio Debian GNU/Linux comes with ABSOLUTELY NO WARRANTY, to the extent
permitted by applicable law.
Welcome to Volumio for Raspberry Pi (5.4.83-v7l+ armv7l)
volumio@volumio-buster-rpi4:~$

From here you can get full access to your device.

Sometimes you will want to run commands that require superuser (or 'root') privileges. To do that use the sudo command. For example:

volumio@192.168.1.80:~$ sudo nano /etc/samba/smb.conf
[sudo] password for volumio:

This runs the command nano /etc/samba/smb.conf as the superuser. When prompted for the password, use the same one you used to log in with.

danger

You can damage your Volumio with sudo. If you delete the wrong file or use incorrect syntax when editing a file, the system may stop working correctly.

Please be aware that editing system files may stop you being able to update Volumio over the air. This is because the system does an integrity check (to make sure the update will apply correctly). If changes are detected, the integrity check will fail and the update will not proceed.

How to enable SSH

For security reasons, SSH is disabled by default on all versions after 2.199 (except first boot). It is easy to enable (and disable).

First method: DEV UI (easy)

Navigate to http://volumio.local/dev or http://yourvolumioip/dev, where 'yourvolumioip' is the actual IP addess of your device eg. 192.168.1.54. Find the SSH section, and click 'enable'. From now on your SSH will be permanently enabled. To disable SSH again, click 'disable'.

Volumio SSH Enable

Note : When clicking on the 'enable' (or 'disable') button, you will see no change in the browser window, but the SSH server will be started (or stopped).

Second method: file (more advanced)

This involves adding a file with a special name to the SD card containing your Volumio.

  • Flash Volumio to the SD card, if you have not done so already

  • Mount the SD card on your computer

  • Create a file called ssh in the /boot partition on the card.

    The file does not need anything inside it, but the name must be ssh.