dockurr/casa repository overview

Docker container of CasaOS⁠, an OS for self-hosting.

⁠Features ✨

• Runs CasaOS inside a Docker container
• Does not need dedicated hardware or a virtual machine
• Provides access to the CasaOS web interface
• Supports installing and running CasaOS apps
• Uses the host Docker daemon for app containers

⁠Usage 🐳

⁠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

⁠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

⁠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 🌟