Run Your Own Personal Cloud Dashboard at Home

// Before you start

What you need

A spare computer, NUC, or Raspberry Pi (amd64, arm64, or armv7)
Debian 12, Ubuntu Server 20.04, or Raspberry Pi OS freshly installed
At least 2 GB RAM and 8 GB storage recommended
The machine must be connected to your local network via ethernet or Wi-Fi
A second device (laptop or phone) to open the dashboard in a browser
Basic comfort running a single command in a terminal or via SSH

Step 1 of 5

Open a terminal on your home server machine

2 min

You need to type one command on the machine that will run CasaOS. If you are sitting at the machine, open the Terminal app. If the machine is headless (no screen), SSH into it from your laptop. On Mac or Linux open Terminal and type 'ssh youruser@192.168.x.x'. On Windows use PuTTY or Windows Terminal.

Terminal · mac

$ ssh youruser@192.168.x.x

What you should see

A command prompt showing youruser@hostname:~$

This might happen

You do not know the machine's IP address

On the server machine, run 'ip a' and look for a line like 'inet 192.168.x.x'. That is the address to SSH into.

Step 2 of 5

Run the one-line CasaOS installer

5 min

This single command downloads and installs everything CasaOS needs — the dashboard, file manager, app store, and background services. It requires sudo (admin) access. The installer will print progress to the screen. Do not close the terminal while it runs.

Terminal · mac

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

What you should see

A series of progress lines ending with something like 'CasaOS is running at http://192.168.x.x' and a port number (usually 80 or 81).

This might happen

curl is not installed on your system

Run 'sudo apt install curl -y' first, then retry the install command.

Step 3 of 5

Open the CasaOS dashboard in your browser

1 min

On any device on the same home network, open a web browser and go to the IP address the installer printed. You will see the CasaOS setup screen asking you to create an admin username and password. Pick something you will remember — this is the only login protecting your dashboard.

Terminal · mac

$ http://192.168.x.x

What you should see

A welcome screen asking you to create a CasaOS account with username and password fields.

This might happen

The page does not load or shows a connection refused error

Wait 30 seconds and refresh. If it still fails, run 'sudo systemctl status casaos' on the server to check if the service started correctly.

Step 4 of 5

Explore the dashboard and install your first app

5 min

After logging in you will see a home screen with widgets showing CPU, memory, and storage. Click the App Store icon to browse apps like Nextcloud (file sync), Jellyfin (media server), or Home Assistant (smart home). Click any app and hit Install. CasaOS pulls the Docker image and sets it up automatically — you do not touch any config files.

Terminal · mac

$ No command needed — use the browser UI

What you should see

The app appears on your home screen with a status indicator. Clicking its icon opens the app in a new browser tab.

This might happen

An app install fails or gets stuck

Check that Docker is running with 'sudo systemctl status docker'. If Docker is not installed, the CasaOS installer should have added it — re-running the install command is safe.

Step 5 of 5

Check your CasaOS version and keep it updated

1 min

CasaOS can update itself from the dashboard. Go to Settings (the gear icon) and click Update if a new version is available. You can also check the current version from the terminal. Updates from the terminal must be done via SSH or a directly attached keyboard — not from the terminal inside the CasaOS UI itself.

Terminal · mac

$ casaos -v

What you should see

A version string such as 'v0.4.x'

This might happen

The 'casaos' command is not found after install

Close and reopen your terminal session, or run 'source ~/.bashrc'. The installer adds casaos to your PATH but the current session may not have picked it up yet.

// Status

cooked. baked. worked.

A clean web dashboard accessible from any browser on your home network, showing system stats and letting you install self-hosted apps like Nextcloud, Jellyfin, or Home Assistant with a single click — no command line needed after setup.

// the honest bit

The honest part

CasaOS is designed for your local home network. It is not hardened for direct exposure to the public internet — do not forward its port to the outside world without adding a VPN or reverse proxy with HTTPS first. The app store is convenient but each app runs as a Docker container with its own resource needs; a Raspberry Pi 3 may struggle if you install several heavy apps at once. CasaOS works best on Debian 12 or Ubuntu Server 20.04 — community-supported systems like ArchLinux or Alpine are not fully tested and may have rough edges.