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

说明与用途

通过 SSH 和 Docker Compose 在 CasaOS 上部署 OpenMuse，确保端口 8787、8081、8790 空闲，并使用提供的 compose 文件避免终端混乱和僵尸进程。

问题

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.

来源