Skip to main content

Docker operations

You can run Pulse in Docker with the published image or by building from local source. Use Docker when you want a repeatable runtime and persistent /data volume.

Published image vs build from source

Volume strategy

Persist /data. It holds SQLite, uploads, board graphs, global discovery, and MCP traces.

Environment variable overrides for production

Inside containers, bind both API and MCP to all interfaces:

Multi-container setups

The community image defaults to local SQLite and embedded LadybugDB files. If you move supporting services out of the container, keep Pulse single-process for the API/UI and MCP servers so shared state and the embedded graph writer stay coherent.

Logs and debugging

Upgrading

For minor releases, pull the new image and restart against the same volume. Check the upgrade guide when a release notes a schema migration.
Last modified on May 8, 2026