Freedom VPN

Open-source member VPN platform

Your nodes.
Your VPN service.

Run a membership-based VPN on your own infrastructure. Freedom VPN brings subscriptions, devices, usage and exit nodes into one place, with self-hosted NetBird and its official apps.

View source on GitHubExplore the connection flow
Layered architecture

Manage centrally. Route traffic through exit nodes.

Member & node controlFreedom VPN

Membership · Usage · Policy · Updates

Admin / Member Portal → Control API · Worker · PostgreSQL
Configuration and node reports
Connection coordinationNetBird CEIdentity, peers & exit routes
Node executionAgent + UpdaterIsolation, metering, shaping & updates
Member Internet traffic
Official appUbuntu exitInternet
WireGuard tunnel; self-hosted Relay when needed
Central services manage members and configuration. Member Internet traffic travels through the selected exit node.

For members, administrators and operators

Members

Review subscriptions, manage devices and track usage in the member portal. Connect to an exit through the official app.

Administrators

Manage membership and nodes across locations. Choose which exits to publish and follow authorization and publication results.

Operators

Maintain nodes through a shared deployment and update workflow, with guides for backup, recovery and troubleshooting.

Everyday service management

From joining the service
to maintaining every exit.

Membership, subscriptions, devices and exits work together. Freedom VPN brings their workflows into one platform, giving your team a place to manage the service and maintain its nodes.

Membership, subscriptions & devices

Connect subscriptions to service entitlement and let members manage their devices. Administrators can adjust access, suspend members and revoke devices.

Member management

Exits across locations

Bring Ubuntu nodes into one inventory, assign names and member groups, and choose when to publish, disable or revoke each exit.

Node management

Usage & fair use

View a member’s usage across devices and exits, apply speed adjustments through fair-use policies, and make the current usage status visible to members.

Usage & policies

Exit traffic & isolation

Apply an Internet-only network model at the exit node. Node-side forwarding rules separate member Internet traffic from the host, private networks and other members.

Network & isolation specification

DNS & domain policies

Maintain domain block and allow lists alongside malicious-domain protection, and apply DNS policies through the service’s resolution path.

DNS & domain management

Node updates & recovery

Assign target releases and follow update results, with signed packages, health checks and recovery from update failures. Runbooks cover backup and restore.

Backup & restore

The member connection path

Official apps. Your own service.

The Freedom VPN member portal handles subscriptions and devices. Official NetBird apps handle VPN connections and manual exit selection, connecting existing clients to your own management environment.

  1. Sign in to the member portal

    Review the subscription plan, device allowance and available exits, and manage your devices.

  2. Set up the official app

    Follow the member guide to install the official NetBird app, set your service’s management URL and sign in with the same identity.

  3. Choose an exit

    Once the device is authorized, manually select an exit in the app. Return to the member portal to review usage and fair-use status.

Member guide

Connection tools & node environment

Purpose Tool or environment
Member portal Browser: subscriptions, devices & usage
Member connection Official NetBird app: VPN connection & exit selection
Exit node Ubuntu 24.04 LTS; amd64 / arm64

The member guide covers app setup and connection steps. The version matrix records component versions, platform details and node environments.

App & component versions

Get started

From your first node
to everyday operations.

Start with the project guide, then follow the development, deployment and operating guides. Find the setup steps for identity, payment integration and nodes in one place.

  1. Explore the service

    Understand the components and find deployment, connection and management guides.

    Project guide

  2. Try the full workflow

    Work through members, nodes and service operations in the isolated development stack.

    Development setup

  3. Set up your service

    Prepare central services, sign-in, payment integration and exit nodes.

    Deployment guide

  4. Manage daily operations

    Handle members, nodes and policies, and follow updates and operation results.

    Operator guide
Also seeConfiguration calibrationBackup & restoreEnglish README

Build your member VPN

Connect your nodes.
Manage your service.

Follow the deployment guide to bring central services, exit nodes and official apps together as one member VPN service.

Read the deployment guideView source on GitHub

The project is under active development. See the documentation for deployment guidance and current support.