Files
zeekay 04314dabdc Serve every route under /v1
The route tree moves from src/app/api to src/app/v1, and every caller
moves with it: the dashboard's useApi base, the tracker and recorder
collect paths, the Next headers and rewrites, the container middleware,
the compose healthchecks and the Cypress API tests. The /v1/analytics
alias is gone; /v1 is the one prefix. The build-time telemetry post to
an upstream endpoint nothing serves is deleted.

v1-surface.test.ts fails if src/app/api returns or any first-party file
names an /api/ path.

Claude-Session: https://claude.ai/code/session_011i2AG9nwpiKUCVxAdDzYuU
2026-09-29 18:41:04 -07:00
..
2026-09-29 18:41:04 -07:00

How to deploy Hanzo Analytics on podman

How to use

  1. Rename env.sample to .env
  2. Edit .env file. At the minimum set the passwords.
  3. Start analytics by running podman-compose up -d.

If you need to stop analytics, you can do so by running podman-compose down.

Install systemd service (optional)

If you want to install a systemd service to run analytics, you can use the provided systemd service.

Edit analytics.service and change these two variables:

WorkingDirectory=/opt/apps/analytics
EnvironmentFile=/opt/apps/analytics/.env

WorkingDirectory should be changed to the path in which podman-compose.yml is located.

EnvironmentFile should be changed to the path in which your .envfile is located.

You can run the script install-systemd-user-service to install the systemd service under the current user.

./install-systemd-user-service

Note: this script will enable the service and also start it. So it will assume that analytics is not currently running. If you started it previously, bring it down using:

podman-compose down

Compatibility

These files should be compatible with podman 4.3+.

I have tested this on Debian GNU/Linux 12 (bookworm) and with the podman that is distributed with the official Debian stable mirrors (podman v4.3.1+ds1-8+deb12u1, podman-compose v1.0.3-3).