readme.md

May 24, 2026 ยท View on GitHub

Build Version Size Package Pulls

Docker container of CasaOS (an OS for self-hosting).

Features โœจ

  • Run CasaOS without the need to install it on your system!

Usage ๐Ÿณ

Via Docker Compose:
services:
  casa:
    image: dockurr/casa
    container_name: casa
    ports:
      - 8080:8080
    volumes:
      - ./casa:/DATA
      - /var/run/docker.sock:/var/run/docker.sock
    restart: always
    stop_grace_period: 1m
Via Docker CLI:
docker run -it --rm --name casa -p 8080:8080 -v "${PWD:-.}/casa:/DATA" -v "/var/run/docker.sock:/var/run/docker.sock" --stop-timeout 60 docker.io/dockurr/casa
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:
  - ./casa:/DATA

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

How do I run ZimaOS in a container?

See dockur/zima for a ZimaOS container.

How do I run UmbrelOS in a container?

See dockur/umbrel for a UmbrelOS container.

Acknowledgements ๐Ÿ™

Special thanks to @worph, this project would not exist without his invaluable work.

Stars ๐ŸŒŸ

Stars