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

  1. Targets → New target, then Application.
  2. Give it a name. The technical identifier (the slug) is derived from it and used in URLs; it does not change afterwards.
  3. Provide at least one platform identifier — the iOS bundle id (com.example.myapp), the Android package name, or both.
  4. 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

  1. Targets → New target, then Server.
  2. Name it. StatHall then generates an agent token shown once and the install command to paste on the machine.
  3. 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.