# Mainfrezzer WireGuard Client

Mainfrezzer WireGuard Client is a self-hosted network services app. WireGuard Bridge is a Docker container that routes your container network traffic through a WireGuard VPN, supporting dual-stack and IPv6-only server configurations. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/2256/mainfrezzer-wireguard-client

## Description

WireGuard Bridge is a Docker container that routes your container network traffic through a WireGuard VPN, supporting dual-stack and IPv6-only server configurations. It bundles Privoxy as an HTTP proxy and microsocks as a SOCKS5 proxy, letting you direct specific container traffic through your VPN without reconfiguring individual containers. Ideal for self-hosters who need fine-grained VPN routing for Docker workloads.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

48/100 (Fair), based on 4 of 4 factors.
- Maintained: 73 (last commit 44 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 80 (1 GB minimum RAM, runs on ARM)

## Links

- GitHub: https://github.com/Mainfrezzer/wireguard-bridge
- Docker Hub: https://hub.docker.com/r/mainfrezzer/wg-bridge
- Unraid: https://ca.unraid.net/apps/mainfrezzer-wireguard-client-0zia7g61cjk8gi?q=mainfrezzer-wireguard-client

## Common questions

### What Docker permissions and Linux setting are required when deploying the container?

Add the NET_ADMIN capability and set the sysctl net.ipv4.conf.all.src_valid_mark=1. The README uses both for Docker run and Compose.

### Which host ports expose the built-in proxy services?

Map 1080/tcp for the microsocks SOCKS5 proxy and 8080/tcp for the Privoxy HTTP proxy. If HTTPPORT is changed, add a matching port mapping.

### How do you specify the IPv4 and IPv6 networks the container should handle?

Set LAN_NETWORK for IPv4 and LAN_NETWORK6 for IPv6. Multiple networks can be listed with a comma as the divider.

### How can you avoid forcing all container traffic through the WireGuard tunnel?

Set DISABLE_TUNNEL_MODE to any value to disable VPN tunnel enforcement. This is useful when containers only need specific VPN IPs while otherwise using the normal internet connection.

### Can the container randomly select a WireGuard client file from the mounted config directory?

Use ENABLE_RANDOM to enable random mode, which picks a file from /etc/wireguard at random. The README shows the variable as an environment setting for that behavior.

### How is the container health check customized?

Set HEALTH_URL_CHECK to a custom URL or IP that the health check should ping. This lets you define the endpoint used for the container's health check.

---
Source: Our Local Host (https://ourlocalhost.com/app/2256/mainfrezzer-wireguard-client), the self-hosted and open-source app directory.
