SSH access

SSH lets you access your Umbrel's command line from another device on your network. This is useful when you can't access the web interface, or if you prefer working in your own terminal app.

If you can access the web interface, the built-in Terminal is an easier option — no setup required, and it works over remote access too.

Connect via SSH

Open a terminal on your computer and run:

ssh umbrel@umbrel.local

Enter your Umbrel login password when prompted.

If umbrel.local doesn't work, use your Umbrel's IP address instead — for example, ssh umbrel@192.168.1.100. See Connecting to your Umbrel for help finding your IP address.

What to know

• SSH is enabled by default on umbrelOS.
• You connect as the umbrel user with your Umbrel login password.
• Use sudo for commands that require elevated permissions. If prompted for a password, it's the same Umbrel login password.
• Changes to the operating system (like packages installed with apt) are not persisted across restarts. See Using the built-in Terminal for more details.