● Set up
Operator console
every page explained.
The console lives at /admin on your server. It changes what the app shows without a new release. Every change is written to an audit log.
01First sign-in and setup code
- Start the server (Installation).
- Find the setup code. If
ADMIN_SETUP_TOKENis empty, the server prints a one-time setup code in its log at start. Look in the terminal, or rundocker logs <container>. If you setADMIN_SETUP_TOKENyourself, use that value. - Open
/adminand enter the code to create the owner account (email and a strong password). - Turn on two-factor sign-in for the owner in the console, as the console asks.
- Remove
ADMIN_SETUP_TOKENfrom.envonce the owner exists, and restart.
Without a session nothing in the console can be read or changed. A read-only demo: Email: demo@textguard.demo · Password: textguard-demo-2026 (read-only demo account)
02Console pages
| Page | What you do there |
|---|---|
| Overview | Health checks and numbers at a glance. The checks warn when support and privacy links are missing, product ids are missing while the paywall is on, store verification is switched on but not configured, the link expander is on but its safety test fails, or the force update has no store link. |
| Brand, Legal | App name, accent colour, support URL, and the privacy and terms URLs, sent to the app. |
| App config: paywall | Paywall on/off, headline, subline, the four product ids (lifetime and yearly, iOS and Android), free checks per day (default 5) and "show paywall on launch after N days" (0 = never on launch). An empty id means that product is not sold. |
| App config: features | Switch the iOS message filter setup, lessons, where to report and check history on or off. |
| App config: scoring | "Suspicious from" (default 3), "Looks like a scam from" (6) and "iOS filter moves to Junk from" (5). See Rule packs. |
| Link expander | Optional, off by default, owner role only. Number of redirects to follow (1 to 6). Read Privacy first. |
| Announcement | A message shown once per announcement. Title, text, optional link, and a "show until" time in UTC like 2026-12-31T23:59:00Z. Editing the text makes it new. Empty title = no announcement. |
| Force update | Minimum version, latest version, App Store and Google Play links, and "Required". With Required on, versions below the minimum see a blocking Update screen with the store link. |
| Rule packs, Report contacts, Lessons | The content of the app. Add, edit, disable, delete and reorder; every change is audited. See Rule packs. |
| Link expander test | Runs the built-in list of forbidden targets against the expander. The Status page warns if it fails. |
| Purchases | Optional store verification. See Purchase verification. |
| Opted-in installs | Counts from people who enabled usage counts: active 1, 7 and 30 days, Pro share, Android and iOS split. These are only the people who opted in, so they are lower than your real total. |
| Revenue | Verified store purchases, shown as gross price (before store fees and tax). Sandbox and test purchases are verified but not recorded. |
| Status, Audit, Team, Export / Import | Server status; the log of every change; invite and manage team members with roles; import and export of settings. |
Beginner tip
Changes reach phones within about five minutes (the config is cached for 5 minutes). People who are offline keep the last copy they saved.
03Screenshots
Captured from the read-only demo console of the shipped server. Money fields are empty because no product ids or store keys ship with the item.



















