ContainerNetwork-AutoFix

Overview

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.

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

Runtime arguments

Network: bridge
Shell: sh
Privileged: false
Extra Params: --restart=unless-stopped -v /var/run/docker.sock:/var/run/docker.sock -v /boot/config/plugins/dockerMan/templates-user:/templates:ro

Template configuration

AppDataPathrw

Optional: Persistent storage for logs

Target: /var/log
Default: /mnt/user/appdata/containernetwork-autofix
Value: /mnt/user/appdata/containernetwork-autofix

Master Container NameVariable

Select your VPN/master container from the dropdown. For custom container names, click EDIT and enter the name in the Value field.

Target: MASTER_CONTAINER
Default: GluetunVPN|OpenVPN-Client|WireGuard|NordVPN|binhex-delugevpn|binhex-qbittorrentvpn

Restart Wait TimeVariable

Seconds to wait after master container restarts before recreating dependents (allows VPN to establish)

Target: RESTART_WAIT_TIME
Default: 15
Value: 15

Max Log LinesVariable

Maximum number of log lines to keep (automatic rotation)

Target: MAX_LOG_LINES
Default: 1000
Value: 1000

Max RetriesVariable

Number of times to retry finding master container on startup

Target: MAX_RETRIES
Default: 10
Value: 10

Retry DelayVariable

Seconds between retry attempts when finding master container

Target: RETRY_DELAY
Default: 10
Value: 10

Links

Template Support Docker Hub Project

Details

Repository

buxxdev/containernetwork-autofix:latest

Registry

https://hub.docker.com/r/buxxdev/containernetwork-autofix

Last Updated2025-10-17

First Seen2025-11-04

Run ContainerNetwork-AutoFix on Unraid.

ContainerNetwork-AutoFix is listed in Community Apps for Unraid OS. Explore Unraid to build a flexible home server, NAS, or homelab.

Explore Unraid OS