FreeSDN is a self-hosted control plane that sits above the controllers and devices you already run, so you manage switches, access points, firewalls, cameras, VoIP, hypervisors, and storage from a single web UI and REST API, no matter who made them. It does not replace your vendors' native controllers, it sits in front of them, normalizes their APIs, and gives you one place to observe and act across all of them at once. Stop logging into eight consoles.
Built and run in production by a small in-house team on a real mixed-vendor stack (Omada, OPNsense, Proxmox, Hikvision, and more). Young software, honestly labeled, not a toy.
Live demo · Documentation · Get started
- One inventory across every site and vendor, with live health at a glance.
- Cross-vendor actions from one place: push a VLAN to switches from different brands, cycle PoE, toggle a WLAN and rotate its PSK, snapshot a camera, update a firewall rule, snapshot or power a VM, reprovision a desk phone.
- Safe by default: every device change is staged and then applied behind a double confirmation, so nothing touches hardware by accident.
- Enterprise plumbing underneath: org / site / device model, role-based access control, an encrypted credential vault, and a full audit trail.
Network · Firewall · Cameras · VoIP · Hypervisor · Storage · Backup · Observability · AI Assistant · Access Control (coming soon)
Production Omada (TP-Link), OPNsense, MikroTik / RouterOS, Proxmox VE, Hikvision, UniFi (Ubiquiti)
Beta pfSense, FreePBX / Asterisk, Grandstream
Preview OpenWrt, TrueNAS, ONVIF (generic)
"Production" means the reference adapter contract is enforced and test-covered, with reads live-validated on real hardware. Full capability matrix: docs.freesdn.org/adapters/overview
git clone https://github.com/freesdn/freesdn.git
cd freesdn
./install.sh # single-node; pick a tier with --tier lite|pro|maxThe installer generates secrets, builds the stack, and waits for health; a first-run wizard sets up your admin account, organization, site, and first controller. Want to kick the tires read-only first? Set ADAPTER_READ_ONLY=true before you start.
| Repo | License | What it is |
|---|---|---|
| freesdn/freesdn | AGPL-3.0 | Core platform: FastAPI backend, React / TypeScript frontend, Celery workers, 12 vendor adapters, Docker-native |
| freesdn/freesdn-agent | MIT | Lightweight host agent with its own signed release pipeline; runs on the managed host and phones home over WebSocket |
| freesdn/freesdn-sdk | MIT | Plugin SDK, published to PyPI as freesdn-sdk. Build your own plugin without touching core |
| freesdn/plugins | MIT | Official plugins: n8n bridge, plugin template, examples |
- Docs: docs.freesdn.org
- Demo: demo.freesdn.org, read-only, no login required
- Security: security@freesdn.org, private disclosure preferred; GitHub private vulnerability reporting also works
- General / press: hello@freesdn.org
FreeSDN is free and open source under AGPL-3.0, with no per-seat or per-device fees and no cloud lock-in. It is young software: we run it in production on real hardware, but there is no third-party security audit or certification yet, so evaluate it for your own environment before you rely on it.
Developed in-house. Every line is authored and reviewed inside the small team that runs it, which keeps the supply chain controlled and the architecture coherent. We don't accept external code pull requests, but bug reports and real-hardware field reports are very welcome via GitHub issues. Want to extend FreeSDN? The MIT SDK lets you build your own plugin for your own use without touching core. Forks are permitted under AGPL.
Two ways to help, if you want to:
- Donate hardware. Ship a supported (or not-yet-supported) device to hardware@freesdn.org. Ownership transfers permanently; during reverse-engineering the device may be modified, reflashed, or destroyed, will not be returned, and there is no compensation. In exchange, that vendor and model gets first-class support that stays under test, and the donor is credited (opt-in) on the supporters wall. This is how new vendor coverage gets built.
- Fuel the build. The team builds and reviews with AI tooling, so gifting a Claude or OpenAI Codex subscription to fuel@freesdn.org directly funds ongoing development. Optional, and entirely up to you.
All product names, logos, and brands are the property of their respective owners. FreeSDN is an independent open-source project and is not affiliated with, endorsed by, or sponsored by any referenced vendor.