# CasaOS — Simple Open-Source Personal Cloud System

> CasaOS is a community-driven personal cloud system built around Docker. It provides a beautiful dashboard for one-click app installation, file management, and device monitoring on any hardware from a Raspberry Pi to a full server.

## Install

Save as a script file and run:

# CasaOS — Simple Open-Source Personal Cloud System

## Quick Use
```bash
# One-line install on Debian/Ubuntu
curl -fsSL https://get.casaos.io | sudo bash

# Access the dashboard
open http://<your-ip>:80
```

## 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.

## Sources
- https://github.com/IceWhaleTech/CasaOS
- https://casaos.io

---
Source: https://tokrepo.com/en/workflows/fff69b5e-39da-11f1-9bc6-00163e2b0d79
Author: Script Depot