CLI

If you want to use the CLI, you can run it with

Docker Compose¶

cd /etc/docker/containers/wg-easy
docker compose exec -it wg-easy cli

Docker Run¶

docker run --rm -it \
    -v ~/.wg-easy:/etc/wireguard \
    ghcr.io/wg-easy/wg-easy:15 \
    cli

Reset Password¶

If you want to reset the password for the admin user, you can run the following command:

By Prompt¶

cd /etc/docker/containers/wg-easy
docker compose exec -it wg-easy cli db:admin:reset

You are asked to provide the new password

By Argument¶

cd /etc/docker/containers/wg-easy
docker compose exec -it wg-easy cli db:admin:reset --password <new_password>

This will reset the password for the admin user to the new password you provided. If you include special characters in the password, make sure to escape them properly.

Show Clients¶

List all clients that are currently configured with details such as client ID, Name, Public Key, and enabled status.

cli clients:list

Show Client QR Code¶

Display the QR code for a specific client, which can be scanned by a compatible app to import the client's configuration.

cli clients:qr <client_id>

Replace <client_id> with the actual client ID you want to show the QR code for.

IPv6 Support

IPv6 support is enabled by default, even if you disabled it using environment variables. To disable it pass the --no-ipv6 flag when running the CLI.

cli clients:qr <client_id> --no-ipv6