Repolode
IceWhaleTech

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 DSMGoogle 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. 1

    Install a supported system and run the one-line installer with wget

    wget -qO- https://get.casaos.io | sudo bash
  2. 2

    Alternatively, run the one-line installer with curl

    curl -fsSL https://get.casaos.io | sudo bash
  3. 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