Search

Accessing the Terminal

umbrelOS includes a built-in terminal interface so you can run commands directly on your Umbrel server when needed. Whether you want to interact with the underlying system (umbrelOS) or run commands inside a specific app, it’s all accessible from the Umbrel dashboard—no SSH required.

Accessing the umbrelOS Terminal

Use this if you want to interact with the operating system that powers your Umbrel server or if you need to make / set up advanced app configurations, such as modifying config files.

  1. From the Umbrel dashboard, go to Settings.

  2. Scroll down to Advanced settings, and click Open.

  3. Under Terminal, click Open.

  4. Choose umbrelOS.

  5. A terminal window will open, allowing you to enter commands.


⚠️ Be cautious—commands run in the umbrelOS terminal can affect your entire system.



Accessing an App’s Terminal

This allows you to run commands inside a specific app container—for example, to check logs, manually restart services, or run advanced tools provided by the app, such as CLI tools to configure certain apps.

The process to access an app's terminal is almost identical to accessing the umbrelOS terminal.

  1. From the Umbrel dashboard, go to Settings.

  2. Scroll down to Advanced settings, and click Open.

  3. Under Terminal, click Open.

  4. Under App, select which app you want to connect a terminal to.

  1. The terminal window will launch inside that app’s environment.

🛠 This is ideal for troubleshooting or power users working with more advanced features of specific apps, eg using bitcoin-cli.