A web desktop operating system for low-power devices like Raspberry Pi, providing file management, network file sharing and a web-based app environment.
IceWhaleTech/CasaOS
CasaOS is an open-source personal cloud system with a home-focused web UI for running Docker apps and managing files on your own hardware.
Open-source alternative to:Synology DSM
Google Drive
- Stars
- 37,335
- Forks
- 2,199
- Open issues
- 838
- Last commit
- 21 days ago
What is it?
CasaOS is a personal cloud operating system meant to turn a spare computer, single-board computer or NAS-style device into a home server. It is designed to be easy to use without a technical background, with a web interface for drive and file management, system and app status widgets, and an app store for one-click installs.
The system runs on amd64, arm64 and armv7 hardware and is installed with a one-line shell script on supported systems such as Debian 12, Ubuntu Server 20.04 and Raspberry Pi OS. Beyond its built-in app store, it can install any app from the Docker ecosystem. Updates can be triggered from the UI or from a terminal.
CasaOS originated as the pre-installed system for the ZimaBoard hardware and is developed as an open-source project with community contributions via Discord and GitHub.
Key features
- 01Web UI designed for home users, with drive and file management.
- 02One-click installs from a built-in app store, including Nextcloud and Home Assistant.
- 03Can install any app from the Docker ecosystem.
- 04Dashboard widgets for resource usage and app status.
- 05Runs on amd64, arm64 and armv7 hardware, including Raspberry Pi.
Use cases
- Turning an old PC or Raspberry Pi into a home file server.
- Self-hosting apps like Nextcloud or Jellyfin without managing Docker by hand.
- Running a home automation hub alongside other household services.
Quick start
- 1
Install a supported system and run the one-line installer with wget
wget -qO- https://get.casaos.io | sudo bash - 2
Alternatively, run the one-line installer with curl
curl -fsSL https://get.casaos.io | sudo bash - 3
Open the CasaOS web interface in your browser after installation
Things to know
- Officially tested only on Debian 12, Ubuntu Server 20.04, and Raspberry Pi OS; other systems are community-supported or not fully tested.
- Installation is a system-level script run with sudo on a dedicated machine, so it suits self-hosting rather than casual use on a laptop.
Topics
FAQ
- What is CasaOS?
- CasaOS is an open-source personal cloud system with a home-focused web UI for running Docker apps and managing files on your own hardware. CasaOS is a personal cloud operating system meant to turn a spare computer, single-board computer or NAS-style device into a home server. It is designed to be easy to use without a technical background, with a web interface for drive and file management, system and app status widgets, and an app store for one-click installs.
- Is CasaOS free to use? What license does it have?
- CasaOS is open source under the Apache-2.0 license. Check the license terms before using it in commercial products.
- Is CasaOS still maintained?
- Actively maintained. The last commit to CasaOS was on Sep 28, 2026.
- What can I use CasaOS for?
- Turning an old PC or Raspberry Pi into a home file server. Self-hosting apps like Nextcloud or Jellyfin without managing Docker by hand. Running a home automation hub alongside other household services.
- How do I install CasaOS?
- Install a supported system and run the one-line installer with wget: wget -qO- https://get.casaos.io | sudo bash Alternatively, run the one-line installer with curl: curl -fsSL https://get.casaos.io | sudo bash Open the CasaOS web interface in your browser after installation
- Where can I get CasaOS?
- The source code and installation instructions are on GitHub: https://github.com/IceWhaleTech/CasaOS
Summary generated by AI from the project's README. GitHub stats refresh daily.
Related projects
Open source digital signage platform that turns Raspberry Pi and PC displays into managed content screens.
A self-hosted, offline-first knowledge base with an extended Markdown editor, team workspaces, OIDC SSO and S3-backed storage.
Self-hosted, Docker-based video surveillance (NVR) for IP cameras with local recording, motion detection, AI object detection and an event timeline.
A free, open-source web panel for managing game servers, running each server in an isolated Docker container.
Self-hosted web page change monitor that alerts you via Discord, Email, Slack, Telegram, webhooks and more when a page changes.