Docker WireGuard

Docker Repository - bfren ecosystem

Comes with WireGuard pre-installed.

Once started you can show configuration for a peer in two ways:

# show configuration as text
wg-conf peer1

# show configuration as QR code
wg-qr peer1

# show all clients
wg-clients

Contents

• Ports
• Volumes
• Environment Variables
• Helper Functions
• Licence / Copyright

Ports

• 51820

Volumes

Volume	Purpose
/config	Stores server and peer configuration values.

Environment Variables

Variable	Values	Description	Default
BF_WIREGUARD_EXTERNAL_ADDRESS	string	The external IP Address or domain of the server - peers will use this to connect.	None - required
BF_WIREGUARD_INTERFACE	string	The name to use for the WireGuard interface.	wg0
BF_WIREGUARD_IP_RANGE	string	The IP range to use for the WireGuard host and peers - without the final segment.	192.168.100
BF_WIREGUARD_DNS	string	The IP Address of an upstream DNS resolver.	1.1.1.1 (Cloudflare)
BF_WIREGUARD_PEERS	string	List of peers to create on startup.	Blank

Helper Functions

Function	Arguments	Description
wg-clients	none	Displays all configured clients with statistics.
wg-conf	0: Peer name	Display a peer's configuration as text.
wg-qr	0: Peer name	Display a peer's configuration as a QR code.

Licence

MIT

Copyright

Copyright (c) 2023-2024 bfren (unless otherwise stated)