IceWhaleTech/CasaOS

DevOps & Self-hosting

Turn a home server into a personal cloud with a web UI for installing Docker apps, managing files and drives.

37,464
2,203
Go
Apache-2.0
5 years old

CasaOS is a Linux-based personal cloud system aimed at home users who want a server-like experience without writing code or editing configuration forms. It provides a web interface for installing curated or arbitrary Docker apps, managing drives and files, and viewing system and app status widgets.

What changes in practice

Instead of maintaining a NAS or server stack by hand, a user installs CasaOS onto a supported base system, then works through the browser: the app store offers one-click installs for services such as Nextcloud, HomeAssistant, AdGuard and Jellyfin, and the Docker ecosystem supplies further apps. The README frames the design goal as "no code, no forms" and a UI intended for home scenarios, which is the main differentiator against command-line-first self-hosting setups.

The system sits on top of the host OS rather than replacing it, so drive and file management and app widgets are exposed as part of one dashboard. A live demo is available for a look before installing.

Requirements and supported paths

Installation targets Linux base systems on amd64/x86-64, arm64 or armv7 hardware. The README lists Debian 12 as the tested, recommended base, alongside tested Ubuntu Server 20.04 and Raspberry Pi OS. Community-tested options include Elementary 6.1 and Armbian 22.04; Alpine, OpenWrt and ArchLinux are marked as not fully tested yet, which matters if you already run one of those.

Setup is a one-line install script run with sudo on a freshly installed supported system, not from the CasaOS web UI terminal. Updates can be triggered from the UI's Settings menu or from a terminal session over SSH or directly attached keyboard; the README explicitly says the terminal update cannot be run from the terminal inside the CasaOS UI. Version checks and uninstalling are handled with the casaos command and casaos-uninstall respectively, with a different uninstall method for versions before v0.3.3.

The project is licensed Apache-2.0, so redistribution and modification are permitted under that licence's terms.

Fit and caveats

CasaOS is a good conceptual fit for someone with spare hardware, or a ZimaBoard/NUC/Raspberry Pi, who wants to host Docker apps and files for a household without learning a full server stack. It is less clearly aimed at users who need fine-grained control over the underlying OS or who run an untested community base system. The README does not describe backup behaviour, data migration, or rollback after an update, so those are not established by the material here. The 2021 Hacker News discussion shows early interest and a newcomer noting it was unclear how such projects compare with alternatives like TrueNAS, NextCloud, unraid or OpenMediaVault — a fair reminder to map specific needs before choosing.

HotRepo's take

The tracked board samples from 2026-06-25 to 2026-10-31 are too sparse to establish a trend; the dated observations alone show 37,456 stars on 2026-10-31 with +37 that day.

Project source and documentation

Written by AI from the project's README, updated October 31, 2026. The project's own docs are the source of truth.

Hacker News

Open-source home cloud OS allows you to run Docker applications without coding
▲ 68 · 19 comments · November 24, 2021
CasaOS: An open-source home server OS for Docker apps
▲ 4 · 0 comments · June 26, 2026