Chargeline docs
v1.0.0
Get help
● 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.

/admintwo-factoraudit log

01First sign-in and setup code

  1. Start the server (Installation).
  2. Find the setup code. If ADMIN_SETUP_TOKEN is empty, the server prints a one-time setup code in its log at start. Look in the terminal, or run docker logs <container>. If you set ADMIN_SETUP_TOKEN yourself, use that value.
  3. Open /admin and enter the code to create the owner account (email and a strong password).
  4. Turn on two-factor sign-in for the owner in the console, as the console asks.
  5. Remove ADMIN_SETUP_TOKEN from .env once the owner exists, and restart.

Without a session nothing in the console can be read or changed. A read-only demo: Email: demo@chargeline.demo · Password: chargeline-demo-2026 (read-only demo account)

02Console pages

PageWhat you do there
OverviewHealth 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, or the force update has no store link.
BrandApp name, accent colour and support URL, sent to the app.
LegalPrivacy and terms URLs.
App config: paywallPaywall on/off, headline, subline, the four product ids (lifetime and yearly, iOS and Android), free history days (default 7), and "show paywall on launch after N days" (0 = never on launch). An empty id means that product is not sold.
App config: featuresSwitch the weekly report, CSV export, capacity log, charge alert and habit cards on or off.
App config: alert limitsDefault, lowest and highest charge target in percent (defaults 80, 50, 100).
AnnouncementA message shown once per announcement. Title, text (400 characters at most), optional link, and a "show until" time in UTC like 2026-12-31T23:59:00Z. Editing the text makes it new, so people who dismissed the old one see it again. Empty title = no announcement.
Force updateMinimum 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.
Habit cardsEdit the Learn cards. Each needs an https source and a review date.
PurchasesOptional store verification. See Purchase verification.
Opted-in installsCounts 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.
RevenueVerified store purchases, shown as gross price (before store fees and tax). The amount shows as unknown when the store does not report it. Sandbox and test purchases are verified but not recorded.
Status, Team, AuditServer status; invite and manage team members with roles; the log of every change; 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. Fields are empty because no product ids or store keys ship with the item.

Console page Overview: The Overview page: health checks and numbers at a glance.
Overview · demo console
Console page Setup, Get started: Get started checklist.
Setup, Get started · demo console
Console page Setup, Brand: Brand: app name, accent colour, support URL.
Setup, Brand · demo console
Console page Product, App config: paywall: Paywall switch, headline and the four product id fields.
Product, App config: paywall · demo console
Console page Product, App config: features: Feature switches.
Product, App config: features · demo console
Console page Product, App config: alert limits: Default, lowest and highest charge target.
Product, App config: alert limits · demo console
Console page Product, Announcement: One-time announcement message.
Product, Announcement · demo console
Console page Product, Force update: Minimum version and store links.
Product, Force update · demo console
Console page Content, Habit cards: Learn cards with source and review date.
Content, Habit cards · demo console
Console page Monitor, Opted-in installs: Counts from people who opted in.
Monitor, Opted-in installs · demo console
Console page Monitor, Status: Server status checks.
Monitor, Status · demo console
Console page Monitor, Audit log: Every change is recorded.
Monitor, Audit log · demo console
Console page Team: Team members and roles.
Team · demo console