A parental control system for UniFi networks that enforces daily time and data limits on internet access per device.

For end users: Download the latest release for your platform:

Quick start:

# Extract the archive
tar -xzf zeitpolizei-*.tar.gz && cd zeitpolizei-*

# Configure (edit with your UniFi credentials)
cp config.example.yaml config.yaml
nano config.yaml

# Run
./zeitpolizei -config config.yaml

See the Installation Guide for detailed instructions for UDM, Docker, Synology, and other platforms.

Main dashboard showing device status and usage

Configure schedules and time limits per device

• Device Management: Configure limits per MAC address
• Usage Tracking: Poll UniFi API for traffic stats, accumulate usage
• Automatic Blocking: Block devices via UniFi API when limit reached
• Flexible Schedules: Different limits for weekdays vs weekends
• Multiple Time Blocks: Define multiple time windows per day with individual limits
• Bonus Time/Data: Parents can add extra time or data on demand
• Web Dashboard: Manage devices, view usage, manual block/unblock

When both limits are set, the first one reached triggers blocking.

# Build for current platform
make build

# Build for UDM (ARM64)
make build-udm

# Build for all platforms
make build-all

Copy and edit the example configuration:

cp config.example.yaml config.yaml

Edit config.yaml:

server:
  address: ":8765"
  username: "admin"
  password: "your-secure-password"

database:
  path: "zeitpolizei.db"

unifi:
  url: "https://192.168.1.1"
  username: "admin"
  password: "your-unifi-password"
  site: "default"
  is_udm: true
  insecure: true

tracker:
  poll_interval: 30s
  activity_min_bytes: 1024

./bin/zeitpolizei -config config.yaml

Access the web UI at http://localhost:8765

1. Build the ARM64 binary:

   make build-udm

2. Copy files to UDM:

   scp bin/zeitpolizei-udm root@<UDM-IP>:/data/zeitpolizei/zeitpolizei
   scp config.yaml root@<UDM-IP>:/data/zeitpolizei/config.yaml
   scp deploy/on_boot.d/10-zeitpolizei.sh root@<UDM-IP>:/data/on_boot.d/

3. Make scripts executable:

   ssh root@<UDM-IP> "chmod +x /data/on_boot.d/10-zeitpolizei.sh /data/zeitpolizei/zeitpolizei"

4. Start Zeitpolizei:

   ssh root@<UDM-IP> "/data/on_boot.d/10-zeitpolizei.sh"

cd deploy/docker
cp ../../config.example.yaml config.yaml
# Edit config.yaml
docker-compose up -d

{
  "name": "Kids iPad",
  "enabled": true,
  "block_outside_time_blocks": true,
  "daily_schedules": [
    {
      "days": ["monday", "tuesday", "wednesday", "thursday", "friday"],
      "time_blocks": [
        {"start_time": "06:00", "end_time": "07:30", "limit_minutes": 30},
        {"start_time": "15:00", "end_time": "18:00", "limit_minutes": 60, "limit_bytes": 536870912}
      ]
    },
    {
      "days": ["saturday", "sunday"],
      "time_blocks": [
        {"start_time": "08:00", "end_time": "21:00", "limit_minutes": 180, "limit_bytes": 2147483648}
      ]
    }
  ]
}

Set is_udm: true in config for UDM devices.

# Run with hot reload (requires air)
make dev

# Run tests
make test

# Run with coverage
make test-cover

# Format code
make fmt

# Run linter
make lint

cd web
npm install
npm run dev

The dev server runs on port 3000 and proxies API requests to :8765.

• Installation Guide - Detailed installation instructions for all platforms
• User Guide - How to use Zeitpolizei, configure devices, and troubleshoot

Contributions are welcome! Please feel free to submit a Pull Request.

1. Fork the repository
2. Create your feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

MIT