Guides
Getting started
- Installation
- Server
- Package repository (pacman and APT)
- Child's computer (Linux)
- Child's computer (Windows)
- Settings in the web interface
Operation
- Updates
- Backup and restore
- Data retention
- Switching to PostgreSQL (one-time)
- Uninstalling (child's computer)
- Games (Steam, Heroic)
Security
Child's computer (Windows)
On this page
On Windows 10/11 the current version provides screen time, sign-out, sign-in lock, “Lock now”, the tray app with chat and extensions, app control, the web filter and the game limit (Steam, Epic Games, EA app, GOG Galaxy, Battle.net, Store games and games started by a launcher such as Ubisoft Connect or Wargaming; further apps can be marked as “Game” in the web interface).
Create child accounts as “Standard user” (Settings → Accounts → Other users), local accounts or Microsoft accounts. KidCTL never restricts administrators – the web interface reports assigned children with administrator rights under “Integrity”.
Web interface → “Devices” → “Add device” → note the pairing code.
On the child’s computer, as administrator, download
KidCTL-Setup-<version>.exefromhttps://kids.example.org/repo/windows/(list of all versions) and run it.Note
The installer is not code-signed (yet): on first launch Windows SmartScreen shows “Windows protected your PC” → “More info” → “Run anyway”. See Code signing.
Enter the server address (
https://kids.example.org) and the pairing code in the installer. Pairing later also works in a command prompt as administrator:"C:\Program Files\KidCTL\kidctl.cmd" enroll https://kids.example.org ABCD-EFGHWeb interface → device → “User assignment”. Windows account names with spaces or umlauts appear as
rid-<number>; the full name (for Microsoft accounts with the email address) is shown next to it.
What differs from Linux
Sign-in lock: when no time is available, KidCTL disables the child’s account. Windows then only shows “Your account has been disabled” – the sign-in screen doesn’t allow a custom notice. This applies to every sign-in method (password, PIN, Windows Hello) and also in safe mode.
Updates are installed by KidCTL itself (checked every 6 hours, signed). No system update needed.
Appearance: the tray app follows the Windows 11 style (light or dark and accent colour as set in Windows; without Mica on Windows 10). The tray icon is the KidCTL symbol with a coloured status dot; the remaining time is shown in the tooltip and at the top of the menu.
Notifications are Windows toasts. If “Do not disturb” is on (also automatically during full-screen games), the tray app additionally shows the last minute and the countdown as a window in the foreground.
Check:
"C:\Program Files\KidCTL\kidctl.cmd" status, service “KidCTL” (services.msc), log atC:\ProgramData\KidCTL\logs\agent.log.App control: the app list in the web interface shows Start menu entries and Store apps (e.g. “Calculator”, “Microsoft Edge”). With app control, the child cannot start programs in their own profile (Downloads, AppData …). Apps that install into the profile (Roblox, Discord …) are installed by the parents with app control “Off” in the child’s account and then allowed – KidCTL then makes their folder executable again.
Web filter: on Windows the filter of the child who is currently signed in at the front applies (for the whole computer); if a parent is at the front, nothing is filtered. A child who stays signed in in the background via “Switch user” has no internet meanwhile. KidCTL points the DNS servers of the network adapters to its own filter; if an administrator stops the service or KidCTL is uninstalled, the original settings come back.
Uninstall: Settings → Apps → Installed apps → KidCTL. Locked accounts are re-enabled, the execution bans removed and the DNS settings restored.
What the installer sets up
One installer (KidCTL-Setup-<version>.exe, Inno Setup) with embedded Python 3.14 and all libraries –
nothing else needs to be installed on the child’s computer.
C:\Program Files\KidCTL\–python\(embedded Python + libraries),lib\(kidctl),kidctl.cmd.C:\ProgramData\KidCTL\– state, logs, updates; access only for SYSTEM and administrators (inheritance removed).- Service
KidCTL(LocalSystem, automatic start, restart on crash), also underHKLM\SYSTEM\CurrentControlSet\Control\SafeBoot\Minimaland\Network. - Tray app in the autostart of all users (
HKLM\…\Run), Start menu entry “KidCTL” with AppUserModelIDKidCTL.Tray(needed for toasts), protocolkidctl://for the buttons in toasts. - Silent installation:
KidCTL-Setup-<version>.exe /VERYSILENT /SERVER=https://… /CODE=ABCD-EFGH.
Updates
Every 6 hours the agent checks latest.json, verifies the Ed25519 signature and the installer’s SHA-256 and
runs it silently. The installer stops the service and tray apps, replaces the files and starts the service; the
agent restarts the tray app in active child sessions.
Uninstalling
“Apps → Installed apps → KidCTL” (as administrator). First the uninstaller re-enables all accounts that
KidCTL has locked (kidctl.cmd unlock-all), then it removes the service, registry entries and
C:\ProgramData\KidCTL.
Package internals (build, signing): packaging/windows/README.md.
Edit on GitHub · German is the source; please change both languages.
