Skip to content
@freesdn

FreeSDN

Manage network gear across brands - Open source & Self-hosted

FreeSDN

One console for all your network gear. Vendor-neutral, self-hosted, open source.

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


What you can do

  • 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.

Ten modules, enable what you need

Network · Firewall · Cameras · VoIP · Hypervisor · Storage · Backup · Observability · AI Assistant · Access Control (coming soon)

Vendor support

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

Quick start

git clone https://github.com/freesdn/freesdn.git
cd freesdn
./install.sh              # single-node; pick a tier with --tier lite|pro|max

The 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.

The repositories

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

Links


How this project works

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:

  1. 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.
  2. 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.

Trademarks

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.

Pinned Loading

  1. freesdn freesdn Public

    FreeSDN is an open-source, vendor-agnostic network management platform that unifies switches, cameras, VoIP phones, firewalls, and access control under a single dashboard.

    Python 3

Repositories

Showing 5 of 5 repositories

People

This organization has no public members. You must be a member to see who’s a part of this organization.

Top languages

Loading…

Most used topics

Loading…