To the knowledge base

Setting up a VPN to the FRITZ!Box in Linux

The vpnc plugin for the GNOME NetworkManager allows you to establish a secure VPN (Virtual Private Network) connection from your Linux computer to your FRITZ!Box over the internet. This allows you to access your FRITZ!Box and devices in your home network with your computer even when you are away from home.

The vpnc plugin is available free of charge for Debian, Fedora, Ubuntu, and other Linux distributions.

Example values used in this guide

In this guide we show you how to connect a computer with Ubuntu 22.04 LTS to the FRITZ!Box. When setting up the connection, replace the values used in this example with your actual values.

  • Dynamic DNS domain name of the FRITZ!Box:
  • Username of the FRITZ!Box user:
    John Smith
  • Password for the FRITZ!Box user:
  • Shared secret of the FRITZ!Box user:

Requirements / Restrictions

  • The packages vpnc, network-manager-vpnc, and network-manager-vpnc-gnome are installed on the computer.

    Note:You can install the packages in Ubuntu as follows:
    sudo apt-get install network-manager-vpnc-gnome

Note:All instructions on configuration and settings given in this guide refer to the latest FRITZ!OS for the FRITZ!Box.

1 Preparations

Setting up dynamic DNS

  1. Set up dynamic DNS in the FRITZ!Box.

Adjusting the FRITZ!Box's IP network

Both ends of the VPN connection must have IP addresses in different IP networks. As soon as the computer is connected to a router (for example another FRITZ!Box) that uses the same IP network as your FRITZ!Box, VPN communication is no longer possible.

Note:All FRITZ!Boxes use the IP network in the factory settings.

Set up an IP address to your FRITZ!Box that differs from the IP addresses of the routers you use to connect to the FRITZ!Box, for example (subnet mask

  1. Click on "Home Network" in the FRITZ!Box user interface.
  2. Click on "Home Network Overview" in the "Home Network" menu.
  3. Click on the "Network Settings" tab.
  4. Click on the "IPv4 Addresses" button. If the button is not displayed, enable the Advanced View first.
  5. Enter the desired IP address and subnet mask.
  6. Click on "OK" to save the settings.

2 Setting up a VPN connection in the FRITZ!Box

Set up a separate user for each VPN connection in the FRITZ!Box:

  1. Click "System" in the FRITZ!Box user interface.
  2. Click "FRITZ!Box Users" in the "System" menu.
  3. Click the (Edit) button for the user who intends to connect to the FRITZ!Box via VPN or set up a new user for the VPN connection:
    1. Click the "Add User" button.
    2. Enter a name and password for the user in the corresponding fields.
  4. Enable the option "VPN".
  5. Click "OK" to save the settings.
  6. Now the FRITZ!Box sets up the VPN connection for the user and opens a window with the VPN settings of the user.

    Note:You can always call up the VPN settings again by clicking "Show VPN Settings" in the settings for the user under "System > FRITZ!Box Users".

3 Setting up and establishing a VPN connection on the computer

Set up the VPN connection on the computer using the VPN settings displayed in the FRITZ!Box user interface for the FRITZ!Box user:

  1. Start the Advanced Network Configuration, for example in the terminal by entering "nm-connection-editor".
  2. Click on the plus sign in the "VPN" section. The "Add VPN" window opens.
  3. In the "Add VPN" window, select "Cisco Compatible VPN (vpnc)".
  4. Enter a name of your choice (FRITZ!Box-VPN) in the "Connection name" field.
  5. Enter the dynamic DNS domain name of the FRITZ!Box ( in the "Gateway" field.
  6. Enter the username of the FRITZ!Box user (John Smith) in the field "Username".
  7. Click the symbol in the field "User password", select "Store the password only for this user", and enter the password for the FRITZ!Box user (secret1234).

    Note:With some Ubuntu versions, you must enable the option "Store the password for all users" instead.

  8. Enter the username of the FRITZ!Box user (John Smith) in the "Group name" field.
  9. Click the symbol in the field "Group password", select "Store the password only for this user", and enter the "shared secret" for the FRITZ!Box user (Zj7hPCouK65IrPU4). The "shared secret" is displayed in the VPN settings of the user in the section "iPhone, iPad or iPod touch".
  10. Click "Advanced".
  11. Enter tun0 in the field "Tunnel interface name" and click "Apply".
  12. Click the "Save" button to complete the configuration. If the button "Save" is grayed out, click "Advanced" again and then "Apply", and save again.
  13. Click the on/off slider for the VPN connection to establish the connection.