CLI Reference

The antics binary serves as both the web server and a CLI tool for data management.

Server Mode (default)

antics

Starts the web server. Configure via environment variables (see Self-Hosted Deployment).

Import Commands

import-umami-csv

Import hourly breakdown data exported from Umami.

antics import-umami-csv <csv_file> <antics_site_id>

CSV format: hour,pathname,referrer_domain,country,browser,os,device,visitors,pageviews

See Import Data for how to generate this CSV from Umami.

Important

Stop the antics server before running import commands. SQLite concurrent write conflicts can cause data loss.

import-csv

Import daily summary data from any source.

antics import-csv <csv_file> <antics_site_id>

CSV format: date,visitors,pageviews

import-sessions

Import session stats (bounce rate, duration) from a CSV.

antics import-sessions <csv_file> <antics_site_id>

CSV format: date,total_sessions,bounced_sessions,total_duration_s

import-umami

Direct import from Umami PostgreSQL (requires network access to PG).

antics import-umami <pg_url> <umami_website_id> <antics_site_id>

Note

The direct PG import requires the antics container to resolve the PG hostname. Minimal OCI images may lack DNS resolution. Use import-umami-csv instead.