mrkeyoor.com_
Mon 02 Nov 19:01 UTC
Self-Hostedevaluationupdated 02 Nov 2026

CasaOS review

CasaOS adds a browser interface for running home-server applications and managing files and drives on an existing Linux system. Its app store and Docker integration aim to make a spare computer useful as a personal server without handling every application through the command line.

Verdict

Our CasaOS npm run installed dependencies in 22 seconds, then failed its OpenAPI build in 1 second without finding TypeScript inputs, so it does not verify a working home server. Consider CasaOS for a spare Linux machine when its app-store approach fits, but first establish that the supported-host installer completes. Keep that trial separate from valuable files until you have checked application storage and a recovery path.

We ran it

Lab card: what happened when we ran CasaOSScreenshot of CasaOS (casaos.zimaspace.com)
Install✓ · 22s1342 packages · 189 MB
Build✗ · 1s
Testsn/ano test script
Known vulns00 critical · 0 high · 0 moderate · 0 low (npm audit)
Repo201 files~14,184 lines of source · 5.7 MB · 10 CI workflows

Answers from our run

Does CasaOS build from source?

Dependencies installed in 22 seconds (1342 packages), and the build failed. We cloned commit 0d3b2f4 into a clean Debian container with 3 CPUs and no project-specific setup.

Does CasaOS have tests you can run?

Not through a standard command: the project exposes no test script or target that our harness could run.

Does CasaOS have known vulnerabilities in its dependencies?

npm audit found none in the dependency tree at the time of our run.

Who should not use CasaOS?

Anyone expecting a replacement operating-system image: the README tells you to install a supported base system first and then run the CasaOS installer.

What are the alternatives to CasaOS?

Runtipi, Portainer Community Edition. Our CasaOS npm run installed dependencies in 22 seconds, then failed its OpenAPI build in 1 second without finding TypeScript inputs, so it does not verify a working home server.

SetupN/AA supported-host CasaOS installation was not reproduced; the measured npm build stopped at an OpenAPI TypeScript target.
Docs3/5Under the stated documentation rubric, the README explains the main host path, support tiers and update access requirements. Installer completion and recovery instructions were not verified.
CommunityN/AThe recent installer discussion shows user activity, but this review did not establish maintainer response times or support capacity.
MaturityN/AThe npm audit and failed OpenAPI build do not assess the Go server, installed apps, storage reliability or recovery behavior.

Who it’s for

Home-server owners who want an app catalog and file-management interface on a supported Linux host.
People repurposing an Intel NUC, Raspberry Pi or spare computer who are willing to administer the underlying system.
Experimenters who can use disposable data while checking the installer, app storage and update route on their hardware.

Who it’s NOT for

Anyone expecting a replacement operating-system image: the README tells you to install a supported base system first and then run the CasaOS installer.
Users requiring fully tested Alpine, OpenWrt or ArchLinux support: the README lists these under community support and marks them not fully tested.
Owners who can only access a terminal through the CasaOS UI: the README says terminal-based updates require SSH or a directly attached terminal instead.
Anyone needing an independently verified working installer today: issue 2589 reports an HTTP 500 while fetching an uninstaller component, and our repository run did not exercise the host installer.

Setup reality

Our October 31, 2026 run at 0d3b2f4 installed npm dependencies in 22 seconds, recording 1,342 dependencies and 189 MB on disk. The build failed with exit 2 in 1 second. Tests were skipped because no test script or target was found. The npm audit reported zero known vulnerabilities. This did not verify installation of the CasaOS server.

The README calls for a freshly installed supported Linux system, internet access for its downloaded installer and sudo privileges. App setup is a separate step: check storage paths and any credentials required by the particular applications you select. The repository result does not measure that work.

The build identifies @icewhale/casaos-openapi and stops at TypeScript TS18003: no inputs were found in tsconfig.json. The log does not explain why inputs were absent. Our configuration listed 3 CPUs, 8 GB RAM and image lab-node:22, without establishing actual runtime or operating-system versions. Debian 12 is the README recommendation, not the environment we verified.

Begin with a Linux host you can afford to rebuild

CasaOS recommends Debian 12 and asks you to install a supported base system before running its installer. That makes a spare computer a sensible place to evaluate it. You are choosing a browser interface for a Linux home server, with an app store and file management. You still need to be comfortable looking after the host when something outside that interface needs attention.

The README lists apps such as Nextcloud, HomeAssistant and Jellyfin, alongside Docker app support. That combination is appealing if your goal is to put familiar services on one machine without starting each deployment from a blank configuration. Our recorded run did not install those apps or inspect their storage behavior. The catalog is a reason to investigate, without evidence here that your chosen service will work on your hardware.

What happened when we ran it

Our CasaOS run installed npm dependencies in 22 seconds, recording 1,342 dependencies and 189 MB on disk. We cloned commit 0d3b2f4 on October 31, 2026. The build failed with exit 2 after 1 second. The log identifies the target as @icewhale/casaos-openapi and shows TypeScript stopping with TS18003 because no inputs were found in tsconfig.json.

The configuration included all paths through **/* and excluded node_modules. That is what the error reports. It does not explain why this target had no eligible inputs, and we cannot infer missing generated files or a package-manager mistake from that tail. The build command included tsc followed by yarn clean, but the visible failure happened at TypeScript. It provides no evidence that the later cleanup step ran.

Tests were skipped because the run found no test script or target. That is an absence of an executed test result, rather than a passing suite. The npm audit reported zero known vulnerabilities. Its scope is the recorded npm dependency audit. It does not establish the security of the Go server, the host installer or any Docker application you subsequently select.

Our measurement setup specified 3 CPUs, 8 GB RAM and image label lab-node:22. Actual runtime and operating-system versions are not established by that label. The scan recorded 201 files, approximately 14,184 source lines and 5.7 MB checked out, with 10 CI workflow files and no detected Dockerfile or tests directory. These are checkout observations, without a supported-host installation or an assessment of the whole CasaOS system.

Platform support has explicit limits

The README names amd64/x86-64, arm64 and armv7 hardware, but its operating-system table is more selective than its broad introductory compatibility language. Debian 12 is recommended under official support, alongside Ubuntu Server 20.04 and Raspberry Pi OS. Alpine, OpenWrt and ArchLinux appear under community support and are marked not fully tested. Read that table before assigning the machine to this project.

For a first trial, use a host from the recommended path and an application whose data you can discard. Confirm where its persistent files live and what remains after you remove or replace the application. That is a proposed evaluation, without a claim that we performed it. A working dashboard would be an encouraging start, but it would leave those storage questions unanswered.

The host installer has a separate reported failure

Issue 2589, opened October 23, 2026, reports HTTP 500 while the host installer fetches an uninstaller component. Other users describe the same error in the thread. This concerns the README's host-installation route, rather than the TypeScript target in our run. Keep the two failures separate when deciding what to investigate or reporting a problem upstream.

The issue remains open in the retrieved record. That does not establish that the endpoint fails for everyone today, and we did not probe it ourselves. Replies offer unofficial workarounds, including an archived download and another installer. Those suggestions have not been validated here. Before setting aside time to migrate a host, check the current issue and confirm that the official route completes on the intended base system.

Keep an update route outside the dashboard

The README allows updates through Settings, but explicitly says a terminal-based update cannot run from the terminal inside the CasaOS UI. It calls for SSH or a directly attached terminal and keyboard. That is a practical reason to arrange host access before relying on the dashboard. Otherwise, the convenient interface could also be your only way into the machine when you need another route.

The latest release endpoint returned v0.4.15, published December 19, 2024. The repository's last push was September 28, 2026, and the October installer discussion shows continuing user activity. An older release tag alone would not establish abandonment. These records also do not establish a dependable release cadence or a maintainer response to the installer report, so support quality remains unassessed.

Runtipi and Portainer CE answer different home-server needs

Runtipi describes a Docker-based home-server orchestrator with a web interface and app stores. It is a relevant alternative for the same app-catalog workflow, with an explicit volunteer-support warning. Portainer CE is a container-management interface whose README targets non-production use. Consider it when container administration is your main goal. We have no comparative reliability or setup measurements for either.

Documentation receives 3/5 on this editorial scale: 1 means no usable path, 2 means sparse instructions, 3 means a main path and limits are documented, 4 requires detailed deployment and recovery guidance, and 5 requires independently verified coverage. Other ratings remain unassessed beyond our recorded repository evidence. Before moving personal files, demonstrate that you can reach the host independently and recover the chosen application's persistent data.

Alternatives

ProjectWhat it isPick it when
RuntipiA Docker-based home-server orchestrator with a web interface and app stores.Pick Runtipi for another app-store-centered home-server evaluation. Its README explicitly says volunteers maintain it without a guarantee of support or security.
Portainer Community Edition gh↗A container-management interface whose README targets homelabs and other non-production uses.Pick Portainer CE when managing containers is the main task and you are comfortable supporting it yourself. Its README directs production and business users to Business Edition.

What people are saying

  1. [github-trending] IceWhaleTech/CasaOS

Sources

  1. CasaOS README
  2. Host installer HTTP 500 report
  3. Runtipi README
  4. Portainer README
  5. Repository metadata
  6. Latest release metadata

More self-hosted reviews

linkwarden · ezbookkeeping · honk · aivpn · Free-GST-Billing-Software · AiSOC · the whole board →