How to Uninstall CasaOS on Raspberry Pi 6 : Complete Guide

CasaOS is a genuinely clever piece of software. It turns a bare Raspberry Pi into a polished home cloud server with a tidy web dashboard. But — like that gym membership you took out in January — sometimes it just needs to go.

Maybe you're switching to a different OS. Maybe CasaOS is conflicting with Docker. Or maybe you just want a clean slate. Whatever the reason, this guide walks you through every removal method — from the official one-liner to full manual cleanup — with zero guesswork.

What Is CasaOS? (Quick Background)

CasaOS is an open-source personal cloud operating system developed by IceWhale Technology. It runs on top of standard Linux distributions — including Raspberry Pi OS — and uses Docker under the hood to manage apps.

• License: Open-source (Apache 2.0)
• Supported hardware: Raspberry Pi 4, Pi 5, ZimaBoard, Intel NUC, x86 machines
• Compatible OS: Ubuntu, Debian, Raspberry Pi OS, and CentOS
• Interface: Browser-based dashboard (no desktop needed)
• GitHub: IceWhaleTech/CasaOS

A note on "Raspberry Pi 6": As of May 2026, the Raspberry Pi Foundation has not officially released a Raspberry Pi 6. Community sources suggest a possible release in late 2026 or 2027. The steps in this guide apply to all current Raspberry Pi models running a Debian-based OS.

Why Would You Uninstall CasaOS?

People remove CasaOS for a handful of sensible reasons. Here are the most common ones:

Before You Start: Checklist

Run through this list before touching a single command. Seriously — five minutes now saves an hour of pain later.

• ✅ Back up your data — containers, app configs, uploaded files
• ✅ SSH access ready — do this from an SSH session, not the CasaOS browser terminal
• ✅ Note your installed apps — list them before removal if you plan to reinstall them elsewhere
• ✅ Know your Pi's IP address — you may need it after reboot
• ✅ Stable power supply — never run system operations on a wobbly USB connection

Method 1: Official Uninstall Command (Recommended)

This is the official method documented by IceWhale Technology in the CasaOS Wiki. It's the cleanest, fastest, and safest way to remove CasaOS.

sudo casaos-uninstall

The two prompts you'll see:

• Prompt 1: "Do you want to remove all containers of CasaOS?" — Answer Yes to remove Docker containers installed via CasaOS.
• Prompt 2: "Do you want to remove all files of CasaOS?" — Answer Yes for a complete removal of app data and config files.

sudo reboot

Source: CasaOS Official Wiki — Guides

Method 2: Manual Cleanup (After the Uninstall Script)

The official script does most of the heavy lifting. But if you want to be absolutely certain no files remain, run these commands as a follow-up.

Step 1 — Stop CasaOS Services

sudo systemctl stop casaos
sudo systemctl stop casaos-user-service
sudo systemctl stop casaos-gateway

Step 2 — Remove Remaining Directories

Common CasaOS file locations to check and remove:

sudo rm -rf /var/lib/casaos
sudo rm -rf /etc/casaos
sudo rm -rf /usr/share/casaos
sudo rm -rf /var/log/casaos

Step 3 — Search for Leftover Files

sudo find / -name "*casaos*" 2>/dev/null

If the find command returns results, review them manually before deleting. Not everything with "casaos" in the name is safe to remove automatically.

Step 4 — Remove CasaOS Systemd Services (if any remain)

sudo systemctl disable casaos 2>/dev/null
sudo rm -f /etc/systemd/system/casaos*.service
sudo systemctl daemon-reload

Method 3: Removing Docker (Optional)

CasaOS installs and manages Docker on your system. Removing CasaOS does not automatically remove Docker. If you want a truly clean system, here's how to remove Docker too.

# Remove Docker packages
sudo apt-get purge docker-ce docker-ce-cli containerd.io docker-compose-plugin -y

# Remove Docker data directories
sudo rm -rf /var/lib/docker
sudo rm -rf /var/lib/containerd

# Clean up
sudo apt-get autoremove -y
sudo apt-get autoclean

Method 4: Full SD Card / Storage Wipe

This is the "nuclear option." You flash a fresh OS image, and CasaOS never existed. It's the most effective method when the uninstall script has failed — for example, due to a broken Docker daemon.

1. Shut down the Pi properly — run sudo shutdown -h now and wait for the activity light to stop blinking.
2. Remove the SD card or NVMe drive from the Raspberry Pi.
3. Connect it to your computer using an SD card reader or USB adapter.
4. Download Raspberry Pi Imager from raspberrypi.com/software.
5. Flash your chosen OS — Raspberry Pi OS, Ubuntu Server, or another image.
6. Reinsert and power on — your Pi boots fresh with no trace of CasaOS.

Which Method Should You Use?

Why Do People Remove CasaOS? (Community Data)

Based on discussions in the Raspberry Pi Forums and the BigBearTech Community, here are the most commonly cited reasons users uninstall CasaOS:

* Estimates based on community forum thread themes, not formal survey data.

Troubleshooting: When Things Go Wrong

The uninstall doesn't always go smoothly. Here's how to handle the most common issues:

Problem: "casaos-uninstall: command not found"

The uninstall binary isn't in your PATH. Try the full path:

sudo /usr/local/bin/casaos-uninstall

If that also fails, the binary may have already been removed. Switch to Method 2 (manual cleanup).

Problem: Docker Daemon Error During Uninstall

If you see "Cannot connect to the Docker daemon", restart Docker first:

sudo systemctl start docker
sudo systemctl enable docker

Then re-run the uninstall command. This is a known issue when running Pi OS from an external NVMe drive, as reported in the Raspberry Pi Forums.

Problem: CasaOS Web UI Still Loading After Uninstall

A browser cache issue, not a system issue. Clear your browser cache or try an incognito tab. If the UI is genuinely still running, check for leftover services:

sudo systemctl list-units | grep casaos

Problem: Pi Won't Boot After Uninstall

This is rare but happens if the uninstall script was interrupted. Your safest fix is the full SD card wipe (Method 4). Attempting repairs on a half-removed system wastes time — a fresh flash is faster and cleaner.

Changed Your Mind? Reinstall CasaOS in 60 Seconds

Uninstalled CasaOS and regret it? No judgement. Getting it back is one command, straight from the official source:

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

That's it. The script installs CasaOS and Docker automatically. Give it two to three minutes, then open your browser at http://<your-pi-ip> to see the dashboard.

Frequently Asked Questions

Final Summary

Uninstalling CasaOS from a Raspberry Pi is not complicated — as long as you use the right method and back up first.

• Quickest way: sudo casaos-uninstall — official, fast, and interactive.
• Deepest clean: Follow up with manual directory removal and a Docker purge.
• Broken install? Flash a fresh OS image. No shame in it — everyone does it eventually.
• Changed your mind? One curl command puts CasaOS right back.

The whole process takes under five minutes for most users. The hardest part is remembering to back up before you start — so go do that now, before you forget.