readme.md
May 24, 2026 ยท View on GitHub
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:
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.

