Enrol a Device
Download the Agent
- From the portal sidebar, go to Settings
- Under the Agent section, click Download Windows Installer
- This downloads the MSI installer for the ChildOnlineSafety agent
Alternatively, the installer is available at https://cos-api.w3i.io/downloads/agent-installer.
Install the Agent
- Copy the MSI installer to the child’s Windows PC
- Double-click the installer and follow the prompts
- The agent installs as a Windows service that starts automatically on boot
- During installation, you’ll be prompted to enter:
- API URL:
https://cos-api.w3i.io - Device name: A friendly name (e.g. “Liam’s Laptop”)
- Child: Select which child this device belongs to
- API URL:
Enrolment
Once installed, the agent:
- Registers itself with the API and receives an API key for authentication
- Begins capturing screenshots every 30 seconds
- Encrypts each screenshot with AES-256-GCM before uploading
- Sends a heartbeat every 60 seconds to report status and check for configuration updates
The device will appear in the portal under the child’s profile within a few seconds.
System Requirements
- OS: Windows 10 or later (64-bit)
- Disk: ~20 MB for the agent, plus temporary screenshot storage
- Network: Internet access to reach
cos-api.w3i.io - Permissions: Administrator access for installation (the agent runs as a system service)
Verify It’s Working
- Go to the portal and navigate to Children → select the child → Devices
- The device should show as Active with a recent “last seen” timestamp
- Go to the Dashboard — you should see screenshot activity within a minute
Note: The agent uses screenshot diff detection to avoid uploading duplicate frames. If the screen hasn’t changed, no upload occurs, saving bandwidth.
Last updated on