Abstract violet and amber illustration representing a personal cloud home server operating system with an app store

CasaOS

CasaOS

CasaOS is an open-source personal cloud operating system: install it on a spare PC, a Raspberry Pi, or a mini PC like IceWhale’s own ZimaBoard, and it turns that hardware into a home server with a web dashboard, a built-in app store, and file management, all sitting on top of Docker. Most homelab guides start with “first, learn Docker Compose.” CasaOS skips that step on purpose: run one command (curl -fsSL https://get.casaos.io | sudo bash) and everything after that happens in a browser tab.

What CasaOS actually does

CasaOS came out of IceWhale in 2020, the same team behind the crowdfunded ZimaBoard mini PC. Their reasoning, as they tell it: nobody had built a home-server OS for people who aren’t already comfortable with Linux and Docker. “Casa” is Spanish for “home,” which is basically the whole design brief in one word: a dashboard and app catalog meant for a shelf in a bedroom, not a server rack.

It’s worth being clear about what CasaOS actually is under the hood: a friendly layer wrapped around the Docker ecosystem. It doesn’t build its own file-sharing tool or its own media server. It takes apps other projects already wrote and gives them a one-click installer and a shared dashboard, including a few apps that already have their own guides on this site.

License: CasaOS is released under the Apache License 2.0. That’s confirmed straight from the LICENSE file at github.com/IceWhaleTech/CasaOS, and it’s repeated in the footer of the official site. This license covers the CasaOS dashboard, gateway, and app-management services themselves, not the apps installed through it; each of those keeps its own license, since CasaOS is really just launching someone else’s Docker image with a nicer interface on top.

Core features

  • One-line installer: a single curl or wget command turns a fresh Debian, Ubuntu, or Raspberry Pi OS install into a running CasaOS instance with a setup wizard. No Docker Compose file needed for the base system.
  • App Store: over 20 pre-installed Docker-based apps plus 50+ community-verified ones, spanning media servers, download clients, and productivity tools. Most install in two clicks.
  • Custom Docker installs: anything with a Docker Hub image and a docker run command can go through the “Custom Install” screen, including apps like Cloudreve that aren’t in the curated store, so the app store catalog isn’t really a ceiling.
  • File management: a built-in Files app for browsing, uploading, and sharing whatever sits on the attached drives, with support for adding disks as storage needs grow.
  • System widgets: CPU, RAM, and storage usage next to the status of every installed app, all on one dashboard, no terminal required.

Installing CasaOS

Here’s the thing that trips people up: CasaOS isn’t a Docker image you docker run, the way Nextcloud or Seafile are. It’s a host-level installer. The official method, documented at github.com/IceWhaleTech/CasaOS, is a one-line script that installs Docker itself if it isn’t already there, then deploys CasaOS’s own services, gateway, app management, local storage, and so on, as system containers running on top.

On a fresh, supported Linux install, that’s:

curl -fsSL https://get.casaos.io | sudo bash

(wget -qO- https://get.casaos.io | sudo bash does the same job if curl isn’t around.) The script takes a couple of minutes, prints out the dashboard URL when it’s done, and everything from there happens in the browser.

Updating later is one click, Settings, then Update, inside the dashboard. Or from a terminal:

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

Uninstalling, on v0.3.3 and up, is just casaos-uninstall.

Community-built Docker images that run CasaOS inside a container do exist. dockurr/casa is one example, and it’s worth flagging that it comes from an unrelated third-party maintainer, not IceWhale. It’s a reasonable way to poke at CasaOS in a VM for ten minutes. But IceWhale doesn’t document or support running it that way for anything real, and there’s a good reason: CasaOS needs direct access to the host’s Docker socket, disks, and systemd services. Nesting it inside another container just adds a layer of complexity that the official installer was built to avoid in the first place.

Hardware: officially supported on Debian 12, Ubuntu Server 20.04, and Raspberry Pi OS, across amd64, armv7, and arm64. IceWhale’s own ZimaBoard is built for it, but any old PC, an Intel NUC, or a Raspberry Pi 4 works fine too. People do run it on Armbian and Alpine as well, though with fewer guarantees that everything behaves. Our homelab setup guide for beginners covers picking hardware for a first Docker project.

Prerequisites

A supported Linux install (Debian, Ubuntu Server, and Raspberry Pi OS are the tested options), root or sudo access, and enough free disk space for whatever apps end up installed. CasaOS installs Docker automatically if it isn’t already on the system, so there’s no separate Docker setup to handle first.

CasaOS vs. the alternatives

CasaOS isn’t really competing with any single self-hosted app. It’s competing with other ways of turning a spare machine into a home server: TrueNAS Scale, OpenMediaVault, Unraid, or just rolling your own with Docker Compose and Portainer.

  • The fastest path from a blank Linux install to a working app store: one command, then a browser tab
  • Free and open source under Apache-2.0, no license fee, unlike Unraid
  • A genuinely uncluttered dashboard, built for people who’ve never touched a Docker Compose file
  • Development has visibly slowed. The latest stable release, v0.4.15, dates back to December 2024, and IceWhale’s own site now pushes ZimaOS, a commercial next-generation NAS OS, as where things are headed
  • Less storage-management depth than TrueNAS Scale: no ZFS, nothing like its RAID tooling
  • No official Docker image, which makes testing it inside an existing container-based homelab more awkward than it probably should be

Against TrueNAS Scale or Unraid, CasaOS trades storage depth for simplicity. Against a hand-built Portainer and Docker Compose setup, it trades flexibility for an easier starting point. Both Nextcloud and Filebrowser Quantum, to pick two examples, install cleanly through CasaOS’s app store or run just as well started by hand outside it.

Official resources

FAQ

Is CasaOS free?

Yes. It’s open source under the Apache License 2.0, and there’s no license fee for the dashboard itself. Whatever apps are installed through it keep their own separate licenses.

Is CasaOS still actively maintained?

It’s still open source, still installable, and still works, but development has clearly slowed down. The latest stable tag is v0.4.15 from December 2024, with only one newer alpha build since. IceWhale now markets ZimaOS as its next-generation successor, so it’s fair to know going in that ZimaOS is where the company’s attention has mostly moved.

Do I need to know Docker to use CasaOS?

No, and that’s kind of the point. CasaOS installs and manages Docker on your behalf, and every app in its store is a couple of clicks, not a compose file to write. Docker knowledge only really helps if the “Custom Install” option gets used, since that expects a docker run command directly.

Can I install CasaOS inside a Docker container?

Not officially. CasaOS is meant to run directly on the host, since it needs to manage the host’s Docker socket and disks. Unofficial images exist if you just want to test it, but the documented, supported path is the one-line installer on bare Linux.