Self-hosted Soha
🚧 Translation in Progress: This page is being translated from Chinese. Some sections may still contain Chinese text.
Self-hosted Soha is the default delivery model for the open-source distribution. The goal is to let users run a complete control plane in their own environment while maintaining a single-binary deployment experience.
Runtime Model
sohaserver provides HTTP API, authentication, RBAC, audit, AI Gateway, MCP / Skills registry, plugin installation records, and the Web console entry.- The Root
soha/websource is built as a Vite SPA; its versioned artifact is embedded in thesoharelease. soha-docsis published independently;sohalinks to documentation via a configured external docs URL.- Root
soha/agentand runners connect to the control plane through the public API / Agent protocol. Core, Web, Contracts, CLI, Agent, Connectors and Skills share the Rootsoharepository; the docs site, Operator and Helm charts remain independent repositories.
Web Resource Modes
soha needs to support three Web resource modes:
embed: Default release mode, the server embeds thesoha/webdist artifact.dir: Read dist from a configured local directory, convenient for local or private builds.proxy: Development mode, proxy to the Vite dev server.
Ordinary users should not be required to start the frontend and backend separately to use self-hosted Soha.
Recommended Entries
Last updated on