ZenStream has one Orchestrator backend and two clients:
For local development, copy .env.example to .env.local and set ZENSTREAM_ORCHESTRATOR_URL to the Orchestrator address reachable from your browser.
ZENSTREAM_ORCHESTRATOR_URL: Runtime URL of the Orchestrator. It may include a path prefix and is read when the web server starts.ZENSTREAM_PORT: Docker host port. It defaults to9086.ZENSTREAM_IMAGE: Docker image to run. It defaults toghcr.io/loco-cto/zenstream:latest.
The container exposes the runtime Orchestrator URL to the browser before the app initializes and applies a Content Security Policy restricted to that configured origin. Artwork capability URLs remain direct requests to the Orchestrator.
Start the Orchestrator first. Requires Node.js and pnpm.
pnpm install
pnpm devFor Docker Compose deployment, copy .env.example to .env, set ZENSTREAM_ORCHESTRATOR_URL, and start the published image:
docker compose pull
docker compose up -dThe web client is available at http://localhost:9086 by default. Stop it with docker compose down.
To pin a version, set ZENSTREAM_IMAGE=ghcr.io/loco-cto/zenstream:vX.Y.Z. Images are also published by full candidate SHA as ghcr.io/loco-cto/zenstream:sha-<full-commit-sha>.
The Compose file keeps its local source build. Run docker compose up -d --build to build the checked-out source instead of pulling the configured image. Changing the Orchestrator URL does not require rebuilding.
pnpm format:check
pnpm lint
pnpm test
pnpm build- If the web client cannot reach the Orchestrator, check that
ZENSTREAM_ORCHESTRATOR_URLis reachable from the browser and allowed by the Orchestrator's CORS configuration. Restart the container after changing the URL; no image rebuild is needed. - For browser or CORS errors, configure the Orchestrator's
ZENSTREAM_PUBLIC_WEB_URLorCORS_ORIGINSfor the web origin.
Tagged web releases are available on GitHub Releases.
AGPL-3.0-or-later. See LICENSE.





