Hometether 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 and how the relay behaves 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, 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: https://hometether-demo.mikodes.com/admin · Email: demo@hometether.demo · Password: hometether-demo-2026 (read-only demo account). The demo host proxies plain HTTP only, so the relay is off there.

02Console pages

Names follow server/src/admin/manifest.ts. Changes reach phones within about five minutes (the config is cached for 5 minutes); people who are offline keep the last copy they saved.

PageWhat you do there
OverviewHealth checks and the numbers at a glance. Checks warn when the secret key is not from the environment, support or privacy links are missing, product ids are missing while the paywall is on, store verification is on but not configured, the force update has no store link, or the relay is on with no public address. A database check is a blocker.
BrandApp name (default Hometether), accent colour (default #C2410C) and the support URL the app opens.
LegalPrivacy and terms URLs, shown in the app's Settings.
App config: paywallPaywall on or off (off hides every Plus offer), headline, subline, the four product ids (lifetime and yearly, iOS and Android; an empty id is not sold), the number of included help sessions per month (default 3, counted on the helper's phone), and "show paywall on launch after N days" (0 = never on launch).
App config: featuresSwitches for remote help (off hides "Ask family for help" and "Help someone"; the parent keeps the on-phone remote), guided fixes, app launch buttons (Roku and LG app shortcuts), power key, QR pairing (off = typed code only) and the parent's own remote.
RelayMaster switch, public relay address, code lifetime, session length, idle timeout, message size, commands per second, helpers per family, sessions per family and day, sessions at once. Full table in Relay.
Supported TVsPlain text (up to 1500 characters) shown under "Which TVs work". Write only models you have tried on real TVs; the app already lists the brands it can talk to. See TV support.
AnnouncementA message shown once. Title (up to 80), text (up to 400), optional link, and a "show until" time in UTC like 2026-12-31T23:59:00Z, required with a title. Editing the text makes it new 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.
PurchasesOptional store verification (off by default), owner only. See Purchase verification.
NotificationsWhere the console sends its alerts: a webhook URL and signing secret (and an e-mail field in the kit's form; the kit itself sends no e-mail).
Guided fixesThe checklists a parent follows: title (up to 60) and 1 to 12 steps (up to 200 characters each). Three starters ship (no sound, wrong input, Wi-Fi lost); edit or delete them. The app contains the same three so it works offline.
Help sessionsCounts only, never content: running now, started in 1, 7 and 30 days, average length, families paired.
Opted-in installsCounts from people who turned on "Share anonymous usage counts": active 1, 7 and 30 days, Plus share, Android and iOS split. Lower than your real total, because it is opt-in.
RevenueVerified store purchases at gross price (before store fees and tax). Empty until you switch verification on.
Status, Team, Audit, Export / ImportServer status; invite and manage team members with roles; a log of every change; import and export of settings.
Beginner tip

Start with Brand, Legal and Relay. Set the public relay address, then check Overview until the warnings you care about are gone.

03Screenshots

Captured from the read-only demo console. All values are sample data; product ids and store keys are empty because none ship with the item.

Console Overview: health checks and numbers
Overview · sample data
Console Brand page
Brand · sample data
Console App config: paywall
App config: paywall · sample data
Console App config: features
App config: features · sample data
Console Relay limits and switch
Relay · sample data
Console Supported TVs text
Supported TVs · sample data
Console Guided fixes checklists
Guided fixes · sample data
Console Help sessions counts
Help sessions · sample data
Console Announcement
Announcement · sample data
Console Force update
Force update · sample data
Console Purchases verification
Purchases · sample data
Console Opted-in installs
Opted-in installs · sample data
Console Team
Team · sample data
Console Audit log
Audit · sample data
Console Status
Status · sample data