Frequently asked questions
Get verified answers about Supermetry privacy, requirements, upgrades, storage, licensing and operations.
Use these answers to resolve common questions before installing or operating Supermetry.
- Find your question below, then follow the linked guide when you need a procedure.
Does the tracker use cookies?
Section titled “Does the tracker use cookies?”No. Pageview and custom-event tracking is cookie-free. The dashboard uses secure authentication cookies for signed-in users; those cookies are not used to track website visitors.
Does Supermetry store raw IP addresses?
Section titled “Does Supermetry store raw IP addresses?”No. It uses the client address during ingestion for location and a daily visitor ID, then discards the raw address. API responses do not expose IP addresses, user agents or visitor IDs.
Does Supermetry fingerprint visitors?
Section titled “Does Supermetry fingerprint visitors?”No. Visitor IDs use a random daily salt, and old salts are deleted after about 48 hours. The ID is scoped to a site and local day rather than being a durable cross-day identity.
Does it respect browser privacy signals?
Section titled “Does it respect browser privacy signals?”Yes. Sec-GPC: 1 and DNT: 1 stop event and heatmap submissions. The browser tracker also honors consent denial or withdrawal and the visitor opt-out API.
What does a self-hosted installation require?
Section titled “What does a self-hosted installation require?”Use Linux, macOS or Windows on AMD64 or ARM64. Docker mode needs Docker Compose. Binary mode needs a reachable PostgreSQL database; the server itself is a single Go binary.
Do I need Redis, ClickHouse or Node.js in production?
Section titled “Do I need Redis, ClickHouse or Node.js in production?”No. Supermetry uses PostgreSQL and does not require Redis or ClickHouse. The production server does not require Node.js.
How do I start the server?
Section titled “How do I start the server?”Run supermetry. It reads ./.env unless SUPERMETRY_ENV_FILE selects another file. Process environment values take precedence.
What is the minimum account password length?
Section titled “What is the minimum account password length?”Passwords must contain at least 6 characters.
How do I upgrade?
Section titled “How do I upgrade?”Run the installer again. It keeps the existing configuration and secret key, replaces the binary or image, restarts the service, and applies database migrations at startup.
Where is self-hosted data stored?
Section titled “Where is self-hosted data stored?”Analytics and account data are stored in your configured PostgreSQL database. Replay files use the configured local replay directory or S3-compatible storage; downloaded GeoIP data uses SUPERMETRY_DATA_DIR.
Where is Supermetry Cloud data hosted?
Section titled “Where is Supermetry Cloud data hosted?”Supermetry Cloud is hosted in the EU. Self-hosted data stays in the PostgreSQL and replay storage that you configure.
What licence does Supermetry use?
Section titled “What licence does Supermetry use?”The core project is licensed under Apache License 2.0.
What is included in a backup?
Section titled “What is included in a backup?”supermetry backup includes a PostgreSQL dump and manifest. It excludes SUPERMETRY_SECRET_KEY, GeoIP databases and replay files, so back those up separately.
- If an operational problem remains, use the troubleshooting guide and include the exact command or startup error.
What you should see: a verified answer above or a linked guide for the next task.