How to choose, use and configure a VPN in FreedomBox (Tutorial)

FreedomBox is a Debian-based, privacy-focused server distribution designed to run on low-power hardware (Raspberry Pi, ODROID, etc.) or as a virtual machine. It’s managed primarily through a web interface, but under the hood it uses apt for packages and follows standard Debian conventions. Most users will be comfortable with minimal to no local desktop environment—if they do spin up a GUI it tends to be lightweight (Xfce or LXDE). System resources are limited, so VPN clients should be lean, well-maintained in Debian repositories, and ideally support modern protocols like WireGuard.

When choosing a VPN service for FreedomBox, look for these criteria:

  • Native Debian/apt support (or easy manual install)
  • WireGuard and/or OpenVPN compatibility
  • Command-line configuration (no heavy GUIs)
  • Reliable documentation for headless servers

Based on those requirements, the top contenders are:

  • Mullvad – excellent WireGuard support, open-source client, Debian packages
  • ProtonVPN – official Linux CLI, strong privacy guarantees, apt repository
  • NordVPN – mature CLI tool, WireGuard (NordLynx), Debian repo
  • AirVPN – rock-solid OpenVPN focus, community-maintained scripts

The following table summarises key technical facets without mentioning pricing:

VPN Service Protocol Support Debian Package / Repo CLI Tool Official Linux Docs
Mullvad WireGuard, OpenVPN Yes (deb package) mullvad CLI Mullvad Linux Guide
ProtonVPN WireGuard, OpenVPN Yes (apt repo) protonvpn-cli ProtonVPN Linux Tool
NordVPN NordLynx (WireGuard), OpenVPN Yes (apt repo) nordvpn NordVPN Linux Setup
AirVPN OpenVPN Community scripts eapi AirVPN Linux Manual

Below you’ll find step-by-step installation and configuration for the two standout options—Mullvad and ProtonVPN—on your FreedomBox system.

1. Installing and Configuring Mullvad on FreedomBox

Mullvad’s Debian package ships a CLI tool that’s perfect for a headless FreedomBox server. We’ll enable WireGuard for best performance and simplicity.

  1. Add the Mullvad repository and install the client:
  2. sudo apt update
    sudo apt install -y apt-transport-https gnupg ca-certificates
    sudo wget -O /usr/share/keyrings/mullvad-archive-keyring.gpg https://packages.mullvad.net/archive-keyring.gpg
    echo deb [signed-by=/usr/share/keyrings/mullvad-archive-keyring.gpg] https://packages.mullvad.net/deb/ focal main  sudo tee /etc/apt/sources.list.d/mullvad.list
    sudo apt update
    sudo apt install -y mullvad-vpn wireguard-tools
        
  3. Authenticate and connect:
  4. # Log in with your Mullvad account number
    mullvad account login YOUR_ACCOUNT_NUMBER
    
    # Generate a WireGuard keypair and register it
    mullvad wireguard generate-keypair
    mullvad wireguard register --local-public-key (mullvad wireguard public-key)
    
    # Start the VPN (choosing a country, e.g. uk)
    mullvad tunnel up wireguard
        
  5. Verify status:
  6. mullvad status
        

2. Installing and Configuring ProtonVPN on FreedomBox

ProtonVPN’s official CLI tool works smoothly on Debian and supports both OpenVPN and WireGuard. Here’s how to set it up:

  1. Add the ProtonVPN repo and install the client:
  2. sudo apt update
    sudo apt install -y wget gnupg lsb-release
    wget -q -O /usr/share/keyrings/protonvpn-archive-keyring.gpg https://repo.protonvpn.com/debian/public_key.asc
    echo deb [signed-by=/usr/share/keyrings/protonvpn-archive-keyring.gpg] http://repo.protonvpn.com/debian stable main  sudo tee /etc/apt/sources.list.d/protonvpn.list
    sudo apt update
    sudo apt install -y protonvpn-cli
        
  3. Initialize and log in:
  4. protonvpn-cli login your@protonmail.com
    # Follow the prompt to enter your ProtonVPN password
        
  5. Connect using WireGuard or OpenVPN:
  6. # For WireGuard (recommended)
    protonvpn-cli c --wireguard
    
    # Or for OpenVPN
    protonvpn-cli c --protocol udp
        
  7. Check connection status:
  8. protonvpn-cli s
        

With those steps, your FreedomBox will channel all outbound traffic through a robust VPN tunnel, preserving both bandwidth efficiency and privacy. Mullvad and ProtonVPN stand out for their Debian integration and headless-friendly tools, making them ideal companions for any FreedomBox deployment.

Download TXT



Leave a Reply

Your email address will not be published. Required fields are marked *