readme.md

May 24, 2026 · View on GitHub

umbrelOS

Build Version Size Package Pulls

Docker container of Umbrel (an OS for self-hosting), making it possible to run it on any system instead of needing a dedicated device.

Features ✨

  • Does not need dedicated hardware or a virtual machine!

Usage 🐳

Via Docker Compose:
services:
  umbrel:
    image: dockurr/umbrel
    container_name: umbrel
    pid: host
    ports:
      - 80:80
    volumes:
      - ./umbrel:/data
      - /var/run/docker.sock:/var/run/docker.sock
    restart: always
    stop_grace_period: 1m
Via Docker CLI:
docker run -it --rm --name umbrel --pid=host -p 80:80 -v "${PWD:-.}/umbrel:/data" -v "/var/run/docker.sock:/var/run/docker.sock" --stop-timeout 60 docker.io/dockurr/umbrel
Via Github Codespaces:

Open in GitHub Codespaces

Screenshot 📸

FAQ 💬

How do I change the storage location?

To change the storage location, include the following bind mount in your compose file:

volumes:
  - ./umbrel:/data

Replace the example path ./umbrel with the desired storage folder or named volume.

How do I run CasaOS in a container?

See dockur/casa for a CasaOS container.

How do I run ZimaOS in a container?

See dockur/zima for a ZimaOS container.

Stars 🌟

Stars