Fritz!Box VPN for Home Assistant (Marketplace integration)

Installs: 162 sharing analytics
GitHub stars: 9
Connection: Works locally
Upkeep: Updated in the last 6 months
Version: v1.2.10, October 27, 2026
Category: Computers and network, Routers and network
Kind: Marketplace integration
Brand: FRITZ!
Needs: Needs the Marketplace (HACS on 2026.10 and older)
Domain: fritzbox_vpn
Source: github.com/rosch100/fritzbox-vpn
Issues: Report an issue

Independent directory, made by the developer of Vulpo. Not affiliated with Home Assistant or the Open Home Foundation.

About

Fritz!Box VPN is an integration that controls WireGuard VPN connections on AVM FritzBox routers. It talks to the router locally and detects the WireGuard connections it finds, then adds a switch for each one to turn it on or off. Alongside the switches it provides a binary sensor for the connected state and sensors for status, connection UID and VPN UID. Home Assistant can discover the router on the network, and credentials from the existing Fritz!Box Tools setup can be reused. The update interval is adjustable, and a setting controls how entities behave when a poll fails temporarily. Two actions clean up entities: one removes those whose VPN connection no longer exists on the router, and the other repairs entity IDs that gained numeric suffixes.

Automatic summary of the README and code of rosch100/fritzbox-vpn. Something wrong, or are you the maintainer and want your own text here? Get in touch

Supports

Works locally Talks to your devices on your own network. No vendor cloud in between.
Found by itself Home Assistant spots it on the network and offers to add it.
From the Marketplace Installed through the Marketplace, formerly HACS.
Actively maintained Its author released or pushed a change in the last six months.

Provides

Switches
Sensors

Setting it up

Install it from the Marketplace and restart Home Assistant, then add it under Settings, Devices and services.

Fritz!Box VPN Configuration

FritzBox IP AddressFritzBox IP address or hostname
UsernameUsername used to authenticate against the FritzBox
PasswordPassword used to authenticate against the FritzBox

Also asked when at the fritz!box vpn found step.

Reauthenticate Fritz!Box VPN

UsernameUsername used to authenticate against the FritzBox
PasswordPassword used to authenticate against the FritzBox

Reconfigure Fritz!Box VPN

FritzBox IP AddressFritzBox IP address or hostname
UsernameUsername used to authenticate against the FritzBox
Password (leave empty to keep current password)Password used to authenticate against the FritzBox
Update interval (seconds, 5–3600, max. 1 h)Update interval in seconds
Entity availability during poll failuresHow entities behave when a poll fails temporarily

After setup

ActionAction to perform
FritzBox IP AddressFritzBox IP address or hostname
UsernameUsername used to authenticate against the FritzBox
Password (leave empty to keep current password)Password used to authenticate against the FritzBox
Update interval (seconds, 5–3600, max. 1 h)Update interval in seconds
Entity availability during poll failuresHow entities behave when a poll fails temporarily
Remove entities and reload integrationCheck to confirm removal and reload
Repair entity IDs and reload integrationCheck to confirm repairing entity IDs and reload

Texts from the code of rosch100/fritzbox-vpn.

Entities

Binary sensorsConnected
SensorsStatus, Connection UID, VPN UID

Actions

Remove unavailable entitiesRemove entities whose VPN connection no longer exists on the Fritz!Box, then reload the integration. Optional: config_entry_id to limit to one integration.Fields: Config entry ID
Repair entity ID suffixesFix entity IDs that got a _2, _3, _4 suffix (e.g. after faulty deactivation). Removes the stale base entry and renames to the base ID. Optional: config_entry_id to limit to one integration.Fields: Config entry ID

Troubleshooting

DiagnosticsDownloads a diagnostics file to attach to a bug report.

From the README

This integration allows you to control WireGuard VPN connections on an AVM Fritz!Box directly through Home Assistant.
Automatic detection of all WireGuard VPN connections
Turn VPN connections on/off via Switch entities
Easy configuration through the Home Assistant UI
Support for multiple VPN connections
Automatic configuration from existing Fritz!Box Tools
Automatic FritzBox discovery via SSDP/UPnP
Configurable update interval (5 seconds to 1 hour; default 30 s)
Session caching: only one login per integration load (no login on every poll), so router access notifications by email stay minimal

From the README of rosch100/fritzbox-vpn, Apache License 2.0. Shortened.