CasaOS is a powerful open-source platform designed for self-hosting applications, file management, and media storage. In this guide, we’ll walk you through installing CasaOS along with Docker on a Debian system.

✅ Prerequisites

Before proceeding, ensure you have:

  • A Debian-based system (Debian 11 or later recommended)

  • A non-root user with sudo privileges

  • Internet connectivity

📌 Step-by-Step Installation Guide

Step 1: Update Your System

It’s always a good practice to update your system before installing new software:

sudo apt update && sudo apt upgrade -y

Step 2: Install Docker

CasaOS requires Docker to function properly. Follow these steps to install Docker correctly:

1. Uninstall Any Old Docker Versions

sudo apt remove -y docker docker-engine docker.io containerd runc

2. Install Required Dependencies

sudo apt install -y ca-certificates curl gnupg

3. Add Docker Repository

sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/debian/gpg | sudo tee /etc/apt/keyrings/docker.asc > /dev/null
sudo chmod a+r /etc/apt/keyrings/docker.asc
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

4. Install Docker

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

5. Start and Enable Docker

sudo systemctl enable --now docker

Verify Docker is running:

sudo systemctl status docker

6. Verify Docker Installation

docker --version
docker run hello-world

Step 3: Install CasaOS

Now, install CasaOS using the official one-liner installation script:

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

This script will:

  • Install required dependencies

  • Set up CasaOS and its services

Step 4: Verify CasaOS Installation

Once the installation is complete, you can access CasaOS through your web browser:

http://YOUR_SERVER_IP:port

(Default port is 80, so simply entering the server IP in the browser should work.)

Step 5: Install Additional Applications

CasaOS includes an App Store where you can install popular applications like:

  • Nextcloud 📂

  • Plex 🎥

  • qBittorrent 🔄

  • Home Assistant 🏠

Step 6: Manage CasaOS via CLI

CasaOS provides a command-line interface to manage apps and settings:

casaos -h

Use this command to see available options.

📢 CasaOS Web Interface Overview

Once installed, navigate to CasaOS in your browser. The dashboard provides easy access to: ✅ Storage Management
✅ Installed Applications
✅ System Monitoring
✅ Docker Containers

🔗 Additional Resources

For more information, visit the official CasaOS Wiki:
CasaOS Wiki

🎥 Recommended YouTube Video:

If you prefer a video tutorial, check out our detailed walkthrough on YouTube:
🔗 EngineerHow YouTube Channel

📌 About EngineerHow.com

EngineerHow.com is your go-to platform for IT and engineering tutorials, focusing on self-hosted solutions, networking, VPS setup, and civil engineering guides. We simplify complex topics to help professionals, enthusiasts, and businesses succeed.

💬 Got questions? Leave a comment below!

🔥 If you found this guide useful, share it with others! 🚀