ReCasaOS

Open-source server dashboard

Your whole server.
One dashboard.

A container manager stops at containers. ReCasaOS also runs the backups, the alerts, the disks, the virtual machines and the other boxes you own. Installed with one command.

curl -fsSL https://github.com/ReCasaOS/CasaOS-Install/releases/latest/download/install.sh | sudo bash

Debian and Ubuntu, on amd64, arm64 and armv7. Run it again to upgrade.

  • Apache-2.0
  • No account, no license key
  • One edition, nothing behind a paywall
  • Docker 20 or later

The dashboard

The whole box on one page.

Processor, memory, disks, last backup, SnapRAID and the other boxes of your fleet, above the apps they run. This is the new dashboard, a beta you turn on in Settings; the classic one stays the default.

The new dashboard: tiles for CPU, memory, storage, network, backups and SnapRAID, a storage panel with four healthy drives, the last backup, a fleet of three boxes online, and twelve running apps such as Jellyfin, Nextcloud and Pi-hole

Rendered with sample data.

Install them from the app store, or paste your own Compose file.

  • Jellyfin
  • Pi-hole
  • Nextcloud
  • Immich
  • Home Assistant
  • Vaultwarden
  • Plex
  • AdGuard Home
  • Gitea
  • Syncthing
  • Uptime Kuma
  • Grafana
  • qBittorrent
  • Navidrome
  • PhotoPrism
  • n8n
  • Sonarr

Beyond containers

Containers are the easy part.

A server is also disks that fail, data that needs a copy somewhere else, and an operating system that runs out of support. ReCasaOS answers for those too.

  • Who backs up the volumes?

    Scheduled, encrypted backups of every app and of the box itself, to S3, SFTP, FTP, WebDAV, OneDrive, Google Drive, Dropbox or anything else rclone speaks. The app is held still for the copy, and a restore puts back an app that is no longer installed.

  • Who tells you a disk is dying?

    A notification on your phone or an e-mail, through ntfy, Telegram, Discord, Gotify, Matrix and more, when a disk fails or fills up, a RAID array loses a disk, a backup fails or an app keeps crashing.

  • Who rebuilds the array?

    Software RAID 0, 1, 5, 6 and 10, created and repaired from the Storage manager. Or SnapRAID parity over ordinary disks, set up in a single dialog, synced every night.

  • Who updates what runs under Docker?

    System packages from the dashboard, Docker itself only when you confirm, and a warning when your Debian or Ubuntu release has run out of security support.

The Backups window: three destinations with their free space, and an encrypted S3 destination being added The Alerts window: an ntfy channel and an e-mail channel, a Telegram channel being added, and the list of events to send
The dashboard, rendered with sample data.

Features

And it is good at containers, too.

01 Compose

Compose, the way you write it

An editor and a .env for every app. Stacks you started with docker compose up are listed as apps. A start that fails after a .env change goes back to the previous one.

02 Git

Push, and the box redeploys

Follow a branch or the highest release tag. Webhooks from GitHub, Gitea, Forgejo and GitLab. New commits build without stopping the running version, and a version that does not start is rolled back.

03 Updates

Updates that say what they will do

Image by image, what an update would change, before you tick it. Opt-in automatic updates run at night, one day after a release, never during a backup.

04 Restic

Incremental backups

Switch a destination to a restic repository: each backup costs only what changed, files keep their owners and permissions, and a restore can put back only the files you tick.

05 Virtual machines

VMs next to your containers

An optional module creates and runs virtual machines from the dashboard: upload an ISO or a disk image, open the console in the browser.

06 Statistics

Seven days of every container

Processor, memory, network and disk of every container, every virtual machine and the machine itself, live and over the last 7 days, with thresholds that raise an alert.

07 Files

Shares that ask who

Shared folders for a guest or an account, Time Machine shares, merged storage with mergerfs, and a trash that keeps what you delete for thirty days.

08 Security

Locked by default

Passwords stored with argon2id, two-factor authentication, HTTPS on 443 without configuring anything, and nothing on the message bus without signing in.

Fleet

Several servers? Still one dashboard.

Make one box the master of the others, wherever they are: at home, at the office, in a datacentre, behind somebody else's router.

  • No port to open

    Each box joins with a code and keeps an outbound connection to the master, so no port opens on any box.

  • Every box at a glance

    The master's Fleet page shows each box, its operating system, its containers and its virtual machines, and says when one goes offline.

  • Act on several at once

    Start, stop and update containers and virtual machines, or update ReCasaOS and the system packages, on the boxes you tick.

Whoever signs in to the master can act on every box: turn on two-factor authentication there.

Why trust it

Made for a box you care about.

Installed before you install it

Every release is installed from scratch by CI and exercised end to end (apps, backup and restore, storage, alerts) on Debian 11, 12 and 13, Ubuntu 22.04, 24.04 and 26.04, Armbian and DietPi.

Checked before it is unpacked

Every ReCasaOS package the installer downloads is verified against a SHA-256 digest before extraction. Docker comes from Docker's own repository, verified by apt.

Free, all of it

Apache-2.0, in the open on GitHub. There is one edition and everything on this page is in it. No account to create, no license key, no feature kept for a paid plan.

Your box stays yours

A Docker that is already there is left as it is and never updated behind your back. sudo casaos-uninstall removes ReCasaOS.

Already running CasaOS?

Same command. It migrates in place.

Upstream stopped shipping in 2025. ReCasaOS carries it on: an install made with IceWhale's or alvins82's installer is migrated without uninstalling first, the Docker 29 breakage is fixed, and the update button then follows this distribution. Services restart during the upgrade, so back up what matters first.

One command away.

curl -fsSL https://github.com/ReCasaOS/CasaOS-Install/releases/latest/download/install.sh | sudo bash

On Proxmox VE, install it in a Debian or Ubuntu virtual machine. Supported systems.