eafxx/rebuild-dndc repository overview

⁠eafxx/rebuild-dndc⁠

Re-create containers that use another container's network stack (e.g. routing container traffic through a VPN container).

• RDNDC will monitor the master container during container re-creation/updates/reboots/host reboots and rebuilds dependent containers using the master container's network stack.
• Any containers using the master container network stack will be auto added to the watch list.
• Monitor master container's WAN connectivity, reboots master container if network is down.
• Only supported on unRAID at the moment.

⁠Prerequisites

1. Make sure the master container (e.g. vpn container) is up & running as expected.
2. Create a docker network named container:master_container_name , to do that, do the following: open terminal > docker network create container:master_container_name note: master container name should be all lower case, rename your container if it isn't.
3. Now edit a container you want to add to the master container network stack
4. You should see the created network (step 2) under 'network type', select that & click 'apply'.

OR

Alternate steps

1. Edit a container you want to add to the master container network stack,
2. Add --net=container:master_container_name in extra parameters and
3. click 'apply'

⁠Docker

Tags

Tag	Description	Build Status
unraid-m	Unraid stable
unraid-d	Unraid development, pre-release
unraid-e	Unraid experimental, unstable

Community Applications (unRAID) - recommended

1. Open the 'Apps' tab and
2. Search for 'rebuild-dndc'
3. Click on the Install button

Docker Run

docker run -d --name='Rebuild-DNDC' --net='bridge' -e TZ="Europe/London" -e HOST_OS="Unraid" -e 'mastercontname'='vpn' -e 'mastercontconcheck'='yes' -e 'ping_ip'='1.1.1.1' -e 'ping_ip_alt'='8.8.8.8' -e 'ping_count'='4' -e 'sleep_secs'='10' -e 'run_startup'='yes' -e 'discord_notifications'='yes' -e 'discord_url'='https://discordapp.com/api/webhooks/xxxxxxxxxxxxxx/xxxxxxxxxxxxxxxxxxx' -e 'cron'='*/5 * * * *' -v '/var/run/docker.sock':'/var/run/docker.sock':'rw' -v '/boot/config/plugins/dockerMan/templates-user':'/config/docker-templates':'ro' -v '/mnt/appdata/rebuild-dndc/config/rebuild-dndc':'/config/rebuild-dndc':'rw' 'eafxx/rebuild-dndc:unraid-m' 

⁠- Parameters

Container images are configured using parameters passed at runtime (such as those above).

⁠- Additional Optional Parameters

⁠- Port Forwarding Optional Parameters

⁠Supported Apps

• ruTorrent

⁠Requirements

• VPN image: qmcgaw/gluetun⁠ (Supports PIA, Mullvad, Windscribe and others)

⁠- Create dependent containers manually

If for some reason master container dependent containers have failed to be created, you can start several containers using a single command, which is far more convenient than doing it through the unRAID GUI.

Interactive Shell

docker exec -it Rebuild-DNDC bash -c 'rebuildm -b container01 container02 container03'

docker exec -it Rebuild-DNDC bash -c 'rebuildm -f container01 container02 container03'

docker exec -it Rebuild-DNDC bash -c 'rebuildm -b $cont_list'

docker exec -it Rebuild-DNDC bash -c 'rebuildm -f $cont_list'

OR

SSH onto Rebuild-DNDC container

rebuildm -b container01 container02 container03

rebuildm -f container01 container02 container03

rebuildm -b $cont_list

rebuildm -f $cont_list

• Replace containerXX with the actual containers you want to create (case-sensitive).
• Manual run is not limited to containers dependent on master container network. As long as the docker template for that container exists, it will create the container.
• -b : Attempts a container rebuild only, if that container already exists, rebuild will be skipped.
• -f : Stop/remove and rebuild containers if it exists or not.
• $cont_list : List of containers that need to rebuild.

⁠Recommended VPN container

You can use any VPN image you want but the following is recommended and ruTorrent port forwarding with RDNDC is supported with the following image (PIA only!)

qmcgaw/gluetun⁠ [Supports PIA, Mullvad, Windscribe and others ]

⁠Credits

• ParseDockerTemplate.sh: author unRAID forum member: skidelo; contributors: Alex R. Berg and eafx; source⁠

• Discord notifications: Discord.sh; source: source⁠

• Logo: based on the icon made by Pause08 from www.flaticon.com⁠