How to Install CasaOS on Raspberry Pi: Complete Home Server Guide

August 24th, 2026

Turning a Raspberry Pi into a home server usually requires working with Docker, storage mounts, and command-line tools. CasaOS on Raspberry Pi simplifies this process by providing a browser-based dashboard for installing applications, managing files, and monitoring the system.In this guide, you’ll learn how to install CasaOS on a Raspberry Pi, configure storage, deploy applications, and avoid common compatibility problems.

What Is CasaOS?

CasaOS is an open-source home server management platform. A typical CasaOS installation does not replace the operating system on a Raspberry Pi. Instead, it runs on top of an existing Linux distribution.

On a Raspberry Pi, a typical CasaOS Raspberry Pi setup uses Raspberry Pi OS Lite as the underlying operating system. CasaOS then provides the graphical management layer, while CasaOS Docker integration allows many applications to run in containers.

Its main features include a web dashboard, application management, file browsing, storage monitoring, Docker integration, and an application store.

This architecture makes CasaOS useful for many Raspberry Pi self-hosting projects, including personal cloud storage, media servers, network utilities, download managers, dashboards, and file servers.

Why Run CasaOS on Raspberry Pi?

One of the biggest advantages is convenience. After installation, most everyday tasks can be performed from a web browser rather than through an SSH terminal.

Applications can also be installed with relatively little configuration. CasaOS provides preconfigured applications that use Docker containers, reducing the amount of manual work involved in creating volumes, mapping ports, and managing containers.

Raspberry Pi hardware is also well suited for building a Raspberry Pi home server. It consumes relatively little electricity and can remain powered continuously without the operating costs of a conventional desktop PC.

This combination works particularly well for users interested in self-hosting services without maintaining a large dedicated server.

Hardware Requirements

• Raspberry Pi: Raspberry Pi 4 or 5 recommended; older models are better suited to lightweight workloads.
• RAM: 4 GB minimum, and 8 GB for multiple or demanding containers.
• Storage: microSD works, but an SSD provides better performance and durability.
• Power: Use the recommended Raspberry Pi power supply.
• Cooling: Active cooling is recommended for Raspberry Pi 5 and continuous workloads.
• Network: Ethernet is preferable for file transfers, media streaming, and reliable server access.

Software Requirements

A clean installation of Raspberry Pi OS Lite 64-bit provides a good starting point. The Lite edition avoids installing an unnecessary desktop environment because CasaOS will be managed through a browser.

SSH should be enabled during the CasaOS Raspberry Pi setup so the Raspberry Pi can be configured remotely.

Using a 64-bit operating system is important because modern container images increasingly target ARM64. Even then, not every Docker application supports ARM processors. Check the application's supported architectures before installing software designed primarily for x86-64 servers.

CasaOS vs Other Raspberry Pi Server Platforms

CasaOS is a strong Raspberry Pi home server option when simplicity and Docker applications are priorities.

OpenMediaVault provides more specialized NAS features, while Raspberry Pi OS offers greater control but requires more manual administration. Umbrel follows a similarly simplified approach but has its own application ecosystem and workflow.

Preparing the Raspberry Pi

Before you install CasaOS on Raspberry Pi, make sure your device is running a clean installation of Raspberry Pi OS Lite 64-bit.SSH should be enabled so that you can complete the setup remotely from another computer.

Before starting the CasaOS installation, connect to the Raspberry Pi through SSH and update the package list and installed packages:
sudo apt update
sudo apt full-upgrade -y

Then check the Raspberry Pi’s local IP address:
hostname -I
Write down the IP address because you will use it to access the CasaOS web interface after installation. Once the updates are complete, reboot the Raspberry Pi:
sudo reboot

Installing CasaOS on Raspberry Pi

The CasaOS installation script automates most of the deployment process on Raspberry Pi.Use the current installation command published by the CasaOS project rather than copying an old command from an outdated tutorial.

Run the installer through your SSH session and allow it to install the necessary components. The process may take several minutes depending on the Raspberry Pi and internet connection.
curl -fsSL https://get.casaos.io | sudo bash

Once the CasaOS Raspberry Pi setup finishes, enter the Pi's IP address in a browser on another computer.

The initial CasaOS screen will guide you through creating the administrator account. After signing in, the main dashboard becomes available.

Understanding the CasaOS Dashboard

The dashboard provides a quick overview of the server. System widgets display information such as processor and memory usage, while storage information helps identify how much disk capacity remains available.

CasaOS on Raspberry Pi also includes a file management interface for navigating directories without relying entirely on terminal commands.

Installed applications appear directly on the dashboard, making them easy to launch and manage. Basic system and CasaOS options are available through the settings area.

Setting Up Storage and File Sharing

External storage is highly recommended when building a Raspberry Pi NAS or home server that will contain media, backups, photographs, or other large collections.

Connect a USB SSD or HDD and confirm that Linux detects it correctly. CasaOS can then use the mounted drive for shared folders and application data.

Folders can be created for different purposes, such as:
Media/Movies
Media/Music
Documents
Backups
SMB sharing makes these directories accessible from computers on the local network. This can turn the Raspberry Pi into a basic Raspberry Pi NAS while still allowing it to host Docker applications.

Whenever possible, keep large application libraries and persistent Docker data on the SSD instead of the system microSD card.

Installing Applications from the CasaOS App Store

Open the CasaOS App Store from the dashboard and select the application you want to deploy. CasaOS Docker integration handles much of the underlying container configuration automatically.

Before installation, review the ports and storage paths. Persistent directories should point to locations that will remain available even if the container is recreated.

Architecture is another important consideration. A Raspberry Pi running a 64-bit operating system normally requires ARM64 Docker images or other ARM64-compatible container images.An application designed exclusively for AMD64/x86-64 may fail to start.

After installation, CasaOS provides controls for starting, stopping, updating, and removing applications.

Practical Example: Building a Raspberry Pi Home Server

A simple project is a Raspberry Pi media server using Jellyfin.

Install Jellyfin through CasaOS and connect its media directories to folders stored on an external SSD. Movies, television programs, and music can remain outside the container, making the library easier to back up and manage.

Before completing the CasaOS Jellyfin installation, open its settings and configure the volume mapping.Select the media folder on your external SSD as the host path and map it to /media inside the Jellyfin container. For example:

Host path: /media/your-drive/Media
Container path: /media

Replace /media/your-drive/Media with the actual path of your external SSD folder. After Jellyfin starts, open its web interface and add /media as the media library location. This keeps your movies and music on the SSD while allowing Jellyfin to access them from inside the container.

Once your Raspberry Pi media server is running with Jellyfin, open its web interface from another computer, smartphone, or television on the same network.

Nextcloud can be used in a similar way if the goal is personal file storage rather than media streaming. The Raspberry Pi stores the data while other devices access it through the network.

Backups, Security, and Performance Tips

Important files should never exist only on your Raspberry Pi home server.Back up personal data and persistent application directories to another disk or system.

Avoid exposing the CasaOS administration interface directly to the public internet. If remote administration is necessary, a VPN solution such as WireGuard or Tailscale is generally preferable to simply forwarding the CasaOS management port through the router.

Storage also has a major influence on performance. Moving applications and data from a microSD card to a Raspberry Pi SSD can noticeably improve responsiveness.

Finally, periodically check available disk space, memory consumption, and Raspberry Pi temperature. Containers can consume storage over time through application data, databases, images, and logs.

Common Problems and Solutions

If the CasaOS installation fails, update Raspberry Pi OS and verify that the Pi has a working internet connection before running the installer again.

If the web interface for CasaOS on Raspberry Pi does not open, confirm the Raspberry Pi's IP address and make sure the CasaOS services are running.

If the App Store does not load, check DNS and internet connectivity.

Applications that install but refuse to run may lack ARM64 support. Check the Docker image architecture before spending time troubleshooting the container.

For external drives used with a Raspberry Pi NAS, confirm that Linux recognizes the device and that it has been correctly mounted.Power-hungry USB hard drives may also require an externally powered enclosure or USB hub.

Finally, a container that refuses to start may have a port conflict. Two applications cannot normally bind to the same host port simultaneously. Change the conflicting port in the application's CasaOS configuration and restart the container.

With reliable storage and a few carefully selected applications, CasaOS can turn a Raspberry Pi into a practical Raspberry Pi home server while keeping Docker and Linux administration relatively simple.

Conclusion

CasaOS provides an easy way to turn a Raspberry Pi into a practical home server without managing every Docker container from the command line. With Raspberry Pi OS Lite 64-bit, reliable cooling, and an external SSD, it can run services such as Jellyfin, Nextcloud, and other self-hosted applications. Remember to check ARM64 compatibility before installing apps, keep important data backed up, and avoid exposing the CasaOS dashboard directly to the internet. For beginners who want a simple web-based server management experience, CasaOS is an excellent place to start.