homelabprivacy

Turn an Old Laptop into a Home Server with CasaOS

🤖 Researched and drafted automatically from the official docs, and reviewed before publishing. Commands are taken from the source projects — but always sanity-check before running anything on your own hardware.

CasaOS is a personal cloud system that turns any old computer—laptop, NUC, Raspberry Pi, or even ancient hardware—into a home server with a polished web UI. Instead of managing Docker containers and systemd services by hand, you get an app store where you click to install Jellyfin, Nextcloud, Home Assistant, AdGuard, and over 100,000 other Docker apps. It’s built for people who want self-hosted services without the terminal complexity.

The install is genuinely one command. CasaOS handles the rest: it sets up the backend, manages storage, and runs everything in Docker. The UI shows you resource usage, app status, and file management without requiring any technical knowledge.

Prerequisites

You need a machine running one of these officially supported systems:

  • Debian 12 (recommended, tested)
  • Ubuntu Server 20.04 or later (tested)
  • Raspberry Pi OS (tested)

CasaOS supports amd64/x86-64, arm64, and armv7 architectures. Community support exists for Elementary 6.1, Armbian 22.04, Alpine, OpenWrt, and ArchLinux, though those aren’t officially tested.

Hardware-wise, older laptops with 4GB RAM and a dual-core processor will run it, though more RAM and storage make a real difference if you plan to host multiple services.

Install CasaOS

  1. Boot your machine with a fresh Debian 12 or Ubuntu Server installation and ensure it has internet access.

  2. Open a terminal and run the official install script:

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

Alternatively, if wget isn’t available:

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

The script will download and install CasaOS, Docker, and all dependencies. It takes a few minutes depending on your internet speed and machine.

  1. Once the install completes, open a web browser on any machine on your LAN and navigate to:
http://<your-server-ip>:80

Replace <your-server-ip> with the IP address of your server. If you’re unsure of the IP, run hostname -I on the server itself.

  1. You’ll be greeted with the CasaOS dashboard. The first time you access it, you may be prompted to set up a user account or configure basic settings.

Access the App Store and Install Services

  1. From the main dashboard, look for an “App Store” or “App Market” section. Click it to browse available applications.

  2. You’ll see curated apps like:

    • Jellyfin – media server (music, movies, TV)
    • Nextcloud – file sync and collaboration
    • Home Assistant – home automation hub
    • AdGuard Home – DNS-level ad blocking
    • Immich – photo backup and gallery
    • Arr stack (Radarr, Sonarr, Lidarr) – media management
  3. Click any app and select “Install.” CasaOS will pull the Docker image, create the container, and start the service. Most apps are ready to use within seconds to a minute.

  4. Once installed, the app appears in your dashboard with a tile showing its status. Click the tile to open the app’s web interface.

Manage Storage and Files

CasaOS includes a file manager accessible from the dashboard. You can:

  • Browse and organize files on your server’s storage
  • Mount external drives (USB, NAS, etc.)
  • Set up shared folders for apps like Nextcloud or Jellyfin to access your media

For Jellyfin or Nextcloud to work well, you’ll want to attach external storage—a USB drive, an old external hard drive, or even a NAS share. Point the app to that storage during setup.

Update CasaOS

  1. From the UI: Open CasaOS, go to Settings, and select Update. The system will fetch the latest version and apply it.

  2. From the terminal (requires SSH or direct access to the machine):

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

Or:

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

Check your current version anytime with:

casaos -v

Monitor and Configure Apps

The dashboard shows resource usage (CPU, memory, disk) in real time. Each app tile displays its status—running, stopped, or error. Click an app to access its settings, logs, or web interface.

Many apps (Nextcloud, Home Assistant, Jellyfin) require initial configuration once installed. CasaOS opens their web UIs automatically, so you can set passwords, add users, and configure libraries without touching the command line.

Security and Network Considerations

CasaOS runs on port 80 by default and is designed for local network access. Keep the admin interface on your LAN or behind a VPN—never expose it to the public internet. If you need remote access to specific apps like Nextcloud or Jellyfin, use a reverse proxy (Nginx, Caddy) with HTTPS, or set up a WireGuard VPN tunnel to your home network. The VPN endpoint’s own port is the exception; that’s meant to be public.

If you’re running multiple services, ensure your server has adequate cooling and power—old laptops can thermal-throttle under sustained load.

Uninstall CasaOS

If you need to remove CasaOS entirely, run:

casaos-uninstall

For versions before v0.3.3:

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

Is It Worth It?

Yes, if you have an old laptop or spare hardware and want a home server without managing Docker by hand. CasaOS abstracts away the complexity—no writing compose files, no SSH into containers, no hunting for ports and environment variables. The app store model means you can spin up Jellyfin for your family’s media, Nextcloud for file sync, and Home Assistant for smart home control all in the same afternoon, on the same machine, without conflict.

The downside: CasaOS is still young, and the curated app selection, while growing, is smaller than what you’d find in a full Docker registry. If you need a very specific or bleeding-edge app, you can still install it manually via the Docker integration, but that requires knowing what you’re doing. For typical home server use cases—media, files, automation, backups—CasaOS is genuinely easier than the alternatives.

Related video

New self-hosted AI & homelab shorts, daily.

Subscribe on YouTube

Related guides

← All guides