A starting point for running Soliplex and related services under Docker Compose.
git clone https://github.com/soliplex/soliplex-template.git
cd soliplex-template
./scripts/generate-secrets.sh # populates .secrets/*.gen (gitignored)
echo 'OLLAMA_BASE_URL=http://your-ollama-host:11434' > .env
docker compose upThen open http://localhost:9000. The terminal client (TUI) is bundled in the
backend image — run it against the stack with
docker compose exec backend soliplex-tui --url http://localhost:8000. This
template also serves the TUI as a web app (the optional tui service) at
https://localhost:9443/tui/.
OLLAMA_BASE_URL must point at an Ollama server that serves the models
referenced in backend/environment/installation.yaml. The first up builds
images and initializes Postgres, so it takes a few minutes.
Full documentation — prerequisites, exposed ports, architecture, secrets, the
RAG pipeline, configuration, and generating a customized project — lives at
https://soliplex.github.io/soliplex-template/ (sources under docs/, built
with Zensical).
Build the docs locally with:
uv run zensical serve # preview at http://localhost:8000
uv run zensical build # static site under site/