Self‑Hosting an AI Assistant on CasaOS: A Step‑by‑Step OpenMuse Install Guide (Pitfalls Included)

Description and use

Deploy OpenMuse on CasaOS via SSH and Docker Compose, ensuring ports 8787, 8081, 8790 are free and using the provided compose files to avoid terminal mangling and stale processes.

Problem

Deploying OpenMuse on CasaOS fails when using the web terminal or when ports are occupied, leading to build errors and runtime failures.

Outcome

OpenMuse runs on CasaOS with stable ports, enabling conversational AI to manage CasaOS containers and access logs.

Workflow

• SSH into CasaOS host from local machine
• Verify ports 8787, 8081, 8790 are free using ss and docker ps
• Create /DATA/AppData/openmuse directory and clone openmuse repo (branch casaos‑manager‑v3)
• Write docker‑compose.yaml, Dockerfile.api, Dockerfile.web, and .env files as per guide
• Run docker compose up --build to build and start containers
• Verify containers health via healthchecks and access API/UI

Evidence

The CasaOS dashboard has a built‑in terminal, and it will betray you: its xterm.js input silently mangles keystrokes mid‑session

Source

If anything shows up, stop/remove it now. Every "address already in use" mystery we've seen traced back to this step being skipped.

Source