Get your hardware ready.

UmbrelOS is free to download and install on your own hardware. Choose your platform on the official GitHub repository or follow our Docker guide.

Official GitHub

Umbrel on Docker: Total Portability with Dockurr

Learn how to run the Umbrel ecosystem as a simple container, without modifying your base operating system.

Why use the Dockurr container?

The official UmbrelOS installer takes control of your Docker and various network settings. The dockurr/umbrel image isolates everything in one place, making it ideal for running on VPS or shared systems.

1. Requirements

You need to have Docker and Docker Compose installed. Make sure port 80 is not being used by another service on the host.

2. Docker Compose

Create your docker-compose.yml file:

services:
  umbrel:
    container_name: umbrel
    image: dockurr/umbrel
    privileged: true
    ports:
      - 80:80
    volumes:
      - ./data:/storage
    restart: on-failure

3. Running

docker-compose up -d

Notice

This is a community-maintained project (Dockurr). Great for portability and testing across different Linux distributions.

How to install UmbrelOS on a PC or Mini PC (x86)

Turn any old computer into a powerful and private home server.

Official GitHub

What you will need

  • PC or Mini PC with a 64-bit processor (Intel or AMD).
  • SSD (min 128GB for apps, 1TB+ for Bitcoin).
  • Wired Ethernet connection.

1. Install Ubuntu Server

UmbrelOS on x86 runs best on top of Ubuntu Server 22.04 LTS or 24.04. Install it on your PC and make sure OpenSSH is enabled.

2. Run the Script

Once logged in via SSH or directly on the terminal, run the official command:

curl -L https://umbrel.sh | bash

Scroll to Top