Introduction
CasaOS transforms any spare computer into a personal cloud server with a polished web dashboard. It wraps Docker with a one-click app store and elegant UI, making self-hosting accessible to users who have never touched a terminal.
What CasaOS Does
- Provides a web-based dashboard for managing self-hosted applications and services
- Offers a built-in app store with one-click install for 100+ Docker containers
- Manages files across local storage and connected drives with a drag-and-drop interface
- Monitors system resources including CPU, memory, disk, and network usage in real-time
- Supports multiple storage devices with automatic mount and RAID-like configurations
Architecture Overview
CasaOS is written in Go and runs as a set of lightweight system services on Linux. It uses Docker under the hood to orchestrate applications, exposing container management through a REST API consumed by a Vue.js frontend. The app store pulls curated Docker Compose definitions from a community-maintained repository, abstracting away YAML configuration entirely.
Self-Hosting & Configuration
- Install on any Debian/Ubuntu-based system with a single curl command
- Runs on x86_64 and ARM architectures, including Raspberry Pi and NAS devices
- Configure network settings, storage mounts, and user accounts through the web UI
- Extend the app store with custom Docker Compose templates or third-party stores
- Access all settings through a REST API for automation and scripting
Key Features
- Beautiful, mobile-friendly dashboard with real-time system monitoring widgets
- One-click app store with curated Docker apps requiring zero configuration
- Built-in file manager with multi-device storage aggregation and sharing
- Automatic Docker network and port management to prevent conflicts
- Community-driven app ecosystem with easy contribution workflow
Comparison with Similar Tools
- Umbrel — Similar personal cloud UX but more opinionated about storage and tightly coupled to its app framework
- Unraid — Powerful NAS OS with Docker support, but proprietary and designed for dedicated hardware
- YunoHost — Focuses on native package installs rather than Docker, with a steeper learning curve
- Runtipi — Lightweight Docker-based homeserver, but smaller app catalog and less polished UI
- Cosmos Cloud — Security-focused Docker dashboard, but newer and with a smaller community
FAQ
Q: What hardware does CasaOS support? A: CasaOS runs on any Linux machine with x86_64 or ARM architecture — from Raspberry Pi 3B+ to full tower servers and old laptops.
Q: Can I install CasaOS on an existing Linux system? A: Yes. CasaOS installs alongside your existing setup without overwriting anything. It adds its services and dashboard on top of your current OS.
Q: Does CasaOS replace Docker Compose? A: CasaOS uses Docker Compose internally but provides a graphical layer on top. You can still use the CLI and manually manage containers alongside CasaOS-managed apps.
Q: Is CasaOS suitable for production or enterprise use? A: CasaOS is designed for personal and home use. For enterprise deployments, consider Portainer or Kubernetes-based platforms.