Technical docs / Docker Compose

Deploy product analytics with Docker Compose.

Run Vectr4 as self-hosted product analytics on your own VPS with Docker Compose, your own domain, and customer event data under your control.

Get deployment ZIP Try Demo

01 / Prepare the VPS

Install Docker Compose on your server

Start with a small VPS, SSH access, Docker Engine, and the Docker Compose plugin. Vectr4 is designed for founders who want a straightforward self-hosted analytics deployment instead of a managed analytics platform.

docker --version
docker compose version

02 / Configure DNS and environment

Point your analytics domain at the VPS

Create an A record such as analytics.example.com that points to the VPS IP. Then set the generated .env values for your domain, admin email, and generated secrets before starting the stack.

VECTR4_DOMAIN=analytics.example.com
[email protected]
VECTRA_ADMIN_ORG_NAME=Example SaaS

03 / Start the analytics stack

Run Vectr4 with Docker Compose

Upload the generated deployment ZIP, extract it on the VPS, review the compose file, and start the services. This brings up product analytics services for event ingestion, dashboards, sessions, and user journeys.

unzip vectr4-deployment.zip -d vectr4
cd vectr4
docker compose pull
docker compose up -d

04 / Verify the deployment

Check containers, HTTPS, and event ingestion

After Docker Compose starts, check container health, open the analytics dashboard, and send a test event from your product. A successful deployment should show events, funnels, sessions, and journeys inside your own infrastructure.

docker compose ps
curl -I https://analytics.example.com
curl https://analytics.example.com/api/health

Trust signal

A product analytics deployment you can inspect.

The Docker Compose deployment model makes the runtime explicit: services, environment values, domains, and storage are visible before you run Vectr4 on your VPS.

Self-hosted product analytics → PostHog alternative → Analytics for indie hackers →