Deploy on Coolify

A Docker Image resource on your own Coolify server. Coolify handles the domain and TLS.

Create the resource

  1. Project → New Resource → Docker Image.
  2. Image: ghcr.io/mddanishyusuf/piqo-selfhost:0.
  3. Under Network, set the exposed port to 3000.
  4. Set the domain to your analytics hostname, for example https://analytics.example.com. Coolify issues the certificate.

Storage

Under Persistent Storage, add a volume with destination path /app/data. Without it every redeploy starts from an empty database.

Environment

AUTH_SECRET=<openssl rand -base64 48>
APP_URL=https://analytics.example.com
PIQO_LICENSE_KEY=PIQOSH-XXXXX-XXXXX-XXXXX-XXXXX

Optionally set the health check to GET /api/health on port 3000.

Finish in the app

Deploy, open the domain, create the owner account on /setup, paste the key on /activate if you didn't set it.

Updating. Click Redeploy. Coolify pulls the current :0 image; migrations run on boot and the volume keeps the data. Turn on “auto update” if you want new 0.x releases picked up on their own.
NextConfiguration