Create a target
A target is what StatHall supervises: a mobile application, a Unix server. Everything else — connectors, alerts, summaries — hangs off a target.
Add an application
- Targets → New target, then Application.
- Give it a name. The technical identifier (the slug) is derived from it and used in URLs; it does not change afterwards.
- Provide at least one platform identifier — the iOS bundle id
(
com.example.myapp), the Android package name, or both. - On the next step, connect your connectors. You may skip it and come back later: a target without connectors is valid, it simply has nothing to show.
Add a server
- Targets → New target, then Server.
- Name it. StatHall then generates an agent token shown once and the install command to paste on the machine.
- Copy the token before closing. If it is lost, generate another one — the previous one is revoked.
The agent installs with a single command and only reads: no remote execution, no change to the machine.
How many targets
The hosted instance applies a fair-use cap per account. It is an infrastructure guardrail, not a commercial tier: StatHall is free and does not bill for it. If you hit it with a legitimate use, write to us — and nothing stops you from self-hosting, that is what the AGPL licence is for.
What happens next
As soon as a connector is configured, collection starts on the next cycle without waiting for you. First data shows within minutes; the full store history takes longer to backfill.