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

Описание и применение

Установка OpenMuse на CasaOS с использованием Docker Compose, SSH и правильной конфигурации портов, чтобы избежать конфликтов и ошибок терминала.

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

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

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

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

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