About this project

CasaOS is an open-source personal cloud system developed by IceWhaleTech and originally pre-installed on the crowdfunded ZimaBoard. The project describes itself as a simple, elegant system aimed at home users who want to store, manage and access their own data without needing deep technical knowledge. The README frames the motivation around falling computing and storage costs, the shift of some cloud workloads toward the edge, and the desire for individuals and small organizations to retain ownership of their data. It also mentions longer-term ideas such as distributed collaboration between personal servers and personalized AI assistants trained on personal data, presented as the team's vision rather than shipped functionality. Key features listed in the README include a friendly UI designed for home scenarios with no code and no forms; support for multiple hardware and base systems such as ZimaBoard, Intel NUC, Raspberry Pi and old computers; a curated app store with one-click installation for apps including Nextcloud, HomeAssistant, AdGuard, Jellyfin and *arr tools; the ability to install numerous Docker applications, with the README stating that over 100,000 apps from the Docker ecosystem can be installed; drive and file management that is described as elegant and requiring no technical background; and system/app widgets showing resource usage, app status and other information at a glance. Installation is handled through a one-line command that supports ZimaBoard, Intel NUC, Raspberry Pi and other computers, and is compatible with Ubuntu, Debian, Raspberry Pi OS and CentOS. The README lists amd64/x86-64, arm64 and armv7 architectures. Officially supported systems are Debian 12 (tested and recommended), Ubuntu Server 20.04 and Raspberry Pi OS, all marked as tested. Community-supported systems include Elementary 6.1 and Armbian 22.04, both tested, while Alpine, OpenWrt and ArchLinux are marked as not fully tested yet. The quick setup command is a wget or curl pipeline piped into sudo bash. Updates can be performed from the UI via Settings, or from a terminal session attached to the device; version checking uses the casaos -v command, and uninstall is available through casaos-uninstall on v0.3.3 or newer, or via a script for older releases. The project is community-driven. The README invites users to join the Discord server, use GitHub Discussions, view the website and demo, and consult the CasaOS wiki for contribution and development guidance. The word Casa comes from the Spanish word for home. Release notes are published on GitHub, and the repository follows the all-contributors specification. The project displays a license badge linking to its LICENSE file, and provides an MIT-style open-source presence without further license details in the README text.