ContainerNetwork-AutoFix
ghcr.io/prophetse7en/containernetwork-autofix:latest
https://github.com/prophetse7en/containernetwork-autofix/pkgs/container/containernetwork-autofix
bridge
sh
false
https://github.com/prophetse7en/containernetwork-autofix/issues
https://github.com/prophetse7en/containernetwork-autofix
ContainerNetwork AutoFix (CNAF) - Automatically recreates Docker containers that depend on a master container's network when the master container restarts. Perfect for containers routing through VPN containers like GluetunVPN.
This is the ProphetSe7en fork of buxxdev/containernetwork-autofix with the Unraid template parser rewritten using xmlstarlet. The rewrite fixes three bugs in the upstream sed-based parser:
- Healthchecks broken after rebuild (XML entities not decoded)
- WebUI right-click broken in Unraid GUI (missing net.unraid.docker.* labels)
- Hardware passthrough lost on rebuild (no Device case in parser)
The fork is a drop-in replacement: same env vars, same mounts, same behavior - only the Repository line needs to change.
When a master container (e.g., VPN) restarts and gets a new container ID, dependent containers using --net=container: lose network connectivity. CNAF automatically detects and recreates those dependent containers.
Features:
- Auto-detects dependent containers
- Preserves container states (running/stopped)
- Smart waiting for VPN establishment
- Automatic log rotation
- Zero manual configuration needed
Tools: Network:VPN Status:Stable
2026-06-06
### 2026-06-06
- v1.3.0: New optional feature. Set `RESTART_STOPPED_DEPENDENTS=true` (under Show advanced) to have CNAF also start dependents that were stopped at the moment the master container restarts. Default stays `false` (original behavior). Only triggers on the master-restart event, CNAF never auto-restarts a container that crashes on its own.
- v1.2.1: Security fix. Passwords, API keys, and tokens passed to dependent containers via `-e VAR=value` are now masked in CNAF's log file. The container itself still receives the real value, only the on-disk log line is sanitized. Delete or rotate your existing log to clear any previously-logged plaintext.
[Full changelog](https://github.com/ProphetSe7en/containernetwork-autofix/blob/main/CHANGELOG.md)
https://raw.githubusercontent.com/prophetse7en/containernetwork-autofix/main/unraid-template.xml
https://raw.githubusercontent.com/prophetse7en/containernetwork-autofix/main/icon.png
--restart=unless-stopped -v /var/run/docker.sock:/var/run/docker.sock -v /boot/config/plugins/dockerMan/templates-user:/templates:ro
/mnt/user/appdata/containernetwork-autofix
vpn-gateway
15
1000
10
10
false