wireguard-ui/examples/docker-compose
Rainbowbreeze 19c031c7ae
Fix error in linuxserver.yml docker compose file
If I understood correctly the meaning of WGUI_MANAGE_START=true var, which starts the wireguard server in the system when the wireguard-ui container starts, I think it should be set to false, because the wireguard server already starts when the linuxserver/wireguard starts , so another "start" is not necessary
2025-07-04 15:13:48 +02:00
..
boringtun.yml Add docker-compose examples (#339) 2023-03-15 21:35:57 +01:00
linuxserver.yml Fix error in linuxserver.yml docker compose file 2025-07-04 15:13:48 +02:00
README.md Add docker-compose examples (#339) 2023-03-15 21:35:57 +01:00
system.yml Add docker-compose examples (#339) 2023-03-15 21:35:57 +01:00

Prerequisites

Kernel Module

Depending on if the Wireguard kernel module is available on your system you have more or less choices which example to use.

You can check if the kernel modules are available via the following command:

modprobe wireguard

If the command exits successfully and doesn't print an error the kernel modules are available. If it does error, you either have to install them manually (or activate if deactivated) or use an userspace implementation. For an example of an userspace implementation, see borigtun.

Credentials

Username and password for all examples is admin by default. For security reasons it's highly recommended to change them before the first startup.

Examples

  • system

    If you have Wireguard already installed on your system and only want to run the UI in docker this might fit the most.

  • linuxserver

    If you have the Wireguard kernel modules installed (included in the mainline kernel since version 5.6) but want it running inside of docker, this might fit the most.

  • boringtun

    If Wireguard kernel modules are not available, you can switch to an userspace implementation like boringtun.