About LocalGuard

1. What is LocalGuard

LocalGuard is a parental control system that runs entirely on your home network. It doesn't rely on external servers — all processing happens on your Docker server.

It stems from a simple idea: parental control shouldn't force you to hand over your family's digital activity to an external provider. The project is designed to be deployed on your network and operate as home infrastructure, not as an opaque service.

2. Operating principles

• Local first: decisions and state live on your own hardware.
• Absolute privacy: zero telemetry and zero functional dependency on third parties.
• Auditable code: the project can be reviewed, deployed and extended without black boxes.
• Realistic operation: Docker Compose, VPS and consumer hardware without bloated architecture.

3. System architecture

LocalGuard consists of three pieces that work together inside your network:

Core (server)

Go backend that handles logic, orchestration and persistence. It's the brain of the system: makes all filtering decisions, stores logs and exposes the REST API consumed by the panel.

Windows Agent

Native binary installed on each PC you want to monitor. Reports network activity and processes to the Core, applies configured rules and inspects SNI traffic without breaking HTTPS or installing certificates.

Web panel

React frontend accessible from any device on your local network. Displays status, configures rules, schedules and manages devices. It doesn't make decisions on its own — everything goes through the Core.

4. Tech stack

• Backend: Go 1.24, REST API, hexagonal architecture.
• Frontend: React 19, Vite, Tailwind CSS, i18next (6 languages).
• Agent: Go compiled for Windows (amd64), native service with watchdog.
• Authentication: PASETO v4 tokens, bcrypt-hashed passwords.
• Database: SQLite — no external dependencies, portable, trivial backup.

5. Deployment

LocalGuard deploys with Docker Compose on any Linux, Windows or Mac machine.

• Docker on any home server or VPS.
• Docker server as a dedicated control point.
• No cloud requirements, public domain or external static IP needed.

Fundación y Liderazgo

Privacidad por Diseño

En LocalGuard, la privacidad no es una configuración, es nuestra arquitectura fundamental. A diferencia de las soluciones comerciales que prometen privacidad mientras recopilan "telemetría anónima", nuestro código está diseñado para que sea técnicamente imposible que veamos tus datos.

6. Open source

The full source code of the project is publicly available on GitHub.

You can audit every line, deploy your own instance and contribute to development. There are no hidden dependencies or proprietary components.

7. Contact

For any questions about the project, write to us at [email protected].