Docker

Single container

docker run -d \
  --name wcp \
  --restart unless-stopped \
  -p 8000:8000 \
  -v wcp_data:/data \
  -e WCP_DB_PATH=/data/sync.db \
  -e WCP_CONFIG_PATH=/data/config.json \
  ghcr.io/lucasmella-stack/wcp:latest

Environment variables

Variable	Default	Description
WCP_DB_PATH	/data/sync.db	SQLite database path
WCP_CONFIG_PATH	/data/config.json	JSON config path
WCP_CORS_ORIGINS	http://localhost:5173	Comma-separated allowed origins
WCP_PORT	8000	HTTP port

Building locally

git clone https://github.com/lucasmella-stack/WCP.git
cd WCP
docker build -t wcp:local .
docker run -d -p 8000:8000 -v wcp_data:/data wcp:local

Health check

The Dockerfile includes a built-in health check:

HEALTHCHECK --interval=30s --timeout=5s --start-period=10s --retries=3 \
    CMD python -c "import urllib.request; urllib.request.urlopen('http://localhost:8000/health')" || exit 1

Data persistence

All data is stored in the /data volume:

/data/
├── sync.db          # SQLite: connections, links, logs, conflicts
└── config.json      # Optional static config

Back up this volume to preserve all your sync history and connections.