From e212c36d85b64286ed9a754b5d99ff4cd65fc385 Mon Sep 17 00:00:00 2001 From: "github-actions[bot]" <41898282+github-actions[bot]@users.noreply.github.com> Date: Sat, 3 May 2025 20:22:32 +0000 Subject: [PATCH] Deployed 923d4a6 to master with MkDocs 1.6.1 and mike 2.1.3 --- master/404.html | 2 +- .../getting-started/reverse-proxy.png | Bin 0 -> 49863 bytes .../configuration/examples/index.html | 2 +- .../configuration/overview/index.html | 6 +- .../getting-started/binaries/index.html | 2 +- .../getting-started/docker/index.html | 10 ++- .../getting-started/helm/index.html | 2 +- .../getting-started/reverse-proxy/index.html | 69 ++++++++++++++++++ .../getting-started/sources/index.html | 2 +- .../monitoring/prometheus/index.html | 2 +- master/documentation/overview/index.html | 2 +- .../documentation/rest-api/api-doc/index.html | 2 +- master/documentation/upgrade/v1/index.html | 4 +- master/index.html | 2 +- master/search/search_index.json | 2 +- master/sitemap.xml | 4 + master/sitemap.xml.gz | Bin 304 -> 316 bytes 17 files changed, 95 insertions(+), 18 deletions(-) create mode 100644 master/assets/images/social/documentation/getting-started/reverse-proxy.png create mode 100644 master/documentation/getting-started/reverse-proxy/index.html diff --git a/master/404.html b/master/404.html index 053ebdd..55048ee 100644 --- a/master/404.html +++ b/master/404.html @@ -1 +1 @@ - WireGuard Portal

404 - Not found

\ No newline at end of file + WireGuard Portal

404 - Not found

\ No newline at end of file diff --git a/master/assets/images/social/documentation/getting-started/reverse-proxy.png b/master/assets/images/social/documentation/getting-started/reverse-proxy.png new file mode 100644 index 0000000000000000000000000000000000000000..fcf3a3f86e016dc7a3c4c0daa730a693fbeecbda GIT binary patch literal 49863 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 AR{#J2 literal 0 HcmV?d00001 diff --git a/master/documentation/configuration/examples/index.html b/master/documentation/configuration/examples/index.html index bd82ede..50073db 100644 --- a/master/documentation/configuration/examples/index.html +++ b/master/documentation/configuration/examples/index.html @@ -1,4 +1,4 @@ - Examples - WireGuard Portal

Examples

Below are some sample YAML configurations demonstrating how to override some default values.

Basic

core:
+ Examples - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Examples
 
Below are some sample YAML configurations demonstrating how to override some default values.
 
Basic
 
core:
   admin_user: test@example.com
   admin_password: password
   admin_api_token: super-s3cr3t-api-token-or-a-UUID
diff --git a/master/documentation/configuration/overview/index.html b/master/documentation/configuration/overview/index.html
index 7fa9d96..a0a2f87 100644
--- a/master/documentation/configuration/overview/index.html
+++ b/master/documentation/configuration/overview/index.html
@@ -1,4 +1,4 @@
- Overview - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Overview
 
This page provides an overview of all available configuration options for WireGuard Portal.
 
You can supply these configurations in a YAML file (e.g. config.yaml) when starting the Portal. The path of the configuration file defaults to config/config.yml in the working directory of the executable.
 It is possible to override configuration filepath using the environment variable WG_PORTAL_CONFIG. For example: WG_PORTAL_CONFIG=/etc/wg-portal/config.yaml ./wg-portal.
 Also, environment variable substitution in config file is supported. Refer to syntax.
 
Configuration examples are available on the Examples page.
 
 Default configuration 
core:
+ Overview - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Overview
 
This page provides an overview of all available configuration options for WireGuard Portal.
 
You can supply these configurations in a YAML file (e.g. config.yaml) when starting the Portal. The path of the configuration file defaults to config/config.yaml (or config/config.yml) in the working directory of the executable.
 It is possible to override configuration filepath using the environment variable WG_PORTAL_CONFIG. For example: WG_PORTAL_CONFIG=/etc/wg-portal/config.yaml ./wg-portal.
 Also, environment variable substitution in config file is supported. Refer to syntax.
 
Configuration examples are available on the Examples page.
 
 Default configuration 
core:
   admin_user: admin@wgportal.local
   admin_password: wgportal
   editable_keys: true
@@ -25,7 +25,7 @@
 
 database:
   debug: false
-  slow_query_threshold: 0
+  slow_query_threshold: "0"
   type: sqlite
   dsn: data/sqlite.db
 
@@ -72,7 +72,7 @@
   url: ""
   authentication: ""
   timeout: 10s
-
 
 
Below you will find sections like core, advanced, database, statistics, mail, auth, web and webhook.
 Each section describes the individual configuration keys, their default values, and a brief explanation of their purpose.
 
 
Core
 
These are the primary configuration options that control fundamental WireGuard Portal behavior. More advanced options are found in the subsequent Advanced section.
 
admin_user
 
     
  • Default: admin@wgportal.local
    •  
  • Description: The administrator user. This user will be created as a default admin if it does not yet exist.
    •  
 
admin_password
 
     
  • Default: wgportal
    •  
  • Description: The administrator password. The default password of wgportal should be changed immediately.
    •  
 
admin_api_token
 
     
  • Default: (empty)
    •  
  • Description: An API token for the admin user. If a token is provided, the REST API can be accessed using this token. If empty, the API is initially disabled for the admin user.
    •  
 
editable_keys
 
     
  • Default: true
    •  
  • Description: Allow editing of WireGuard key-pairs directly in the UI.
    •  
 
create_default_peer
 
     
  • Default: false
    •  
  • Description: If a user logs in for the first time with no existing peers, automatically create a new WireGuard peer for all server interfaces.
    •  
 
create_default_peer_on_creation
 
     
  • Default: false
    •  
  • Description: If an LDAP user is created (e.g., through LDAP sync) and has no peers, automatically create a new WireGuard peer for all server interfaces.
    •  
 
re_enable_peer_after_user_enable
 
     
  • Default: true
    •  
  • Description: Re-enable all peers that were previously disabled if the associated user is re-enabled.
    •  
 
delete_peer_after_user_deleted
 
     
  • Default: false
    •  
  • Description: If a user is deleted, remove all linked peers. Otherwise, peers remain but are disabled.
    •  
 
self_provisioning_allowed
 
     
  • Default: false
    •  
  • Description: Allow registered (non-admin) users to self-provision peers from their profile page.
    •  
 
import_existing
 
     
  • Default: true
    •  
  • Description: On startup, import existing WireGuard interfaces and peers into WireGuard Portal.
    •  
 
restore_state
 
     
  • Default: true
    •  
  • Description: Restore the WireGuard interface states (up/down) that existed before WireGuard Portal started.
    •  
 
 
Advanced
 
Additional or more specialized configuration options for logging and interface creation details.
 
log_level
 
     
  • Default: info
    •  
  • Description: The log level used by the application. Valid options are: trace, debug, info, warn, error.
    •  
 
log_pretty
 
     
  • Default: false
    •  
  • Description: If true, log messages are colorized and formatted for readability (pretty-print).
    •  
 
log_json
 
     
  • Default: false
    •  
  • Description: If true, log messages are structured in JSON format.
    •  
 
start_listen_port
 
     
  • Default: 51820
    •  
  • Description: The first port to use when automatically creating new WireGuard interfaces.
    •  
 
start_cidr_v4
 
     
  • Default: 10.11.12.0/24
    •  
  • Description: The initial IPv4 subnet to use when automatically creating new WireGuard interfaces.
    •  
 
start_cidr_v6
 
     
  • Default: fdfd:d3ad:c0de:1234::0/64
    •  
  • Description: The initial IPv6 subnet to use when automatically creating new WireGuard interfaces.
    •  
 
use_ip_v6
 
     
  • Default: true
    •  
  • Description: Enable or disable IPv6 support.
    •  
 
config_storage_path
 
     
  • Default: (empty)
    •  
  • Description: Path to a directory where wg-quick style configuration files will be stored (if you need local filesystem configs).
    •  
 
expiry_check_interval
 
     
  • Default: 15m
    •  
  • Description: Interval after which existing peers are checked if they are expired. Format uses s, m, h, d for seconds, minutes, hours, days, see time.ParseDuration.
    •  
 
rule_prio_offset
 
     
  • Default: 20000
    •  
  • Description: Offset for IP route rule priorities when configuring routing.
    •  
 
route_table_offset
 
     
  • Default: 20000
    •  
  • Description: Offset for IP route table IDs when configuring routing.
    •  
 
api_admin_only
 
     
  • Default: true
    •  
  • Description: If true, the public REST API is accessible only to admin users. The API docs live at /api/v1/doc.html.
    •  
 
 
Database
 
Configuration for the underlying database used by WireGuard Portal. Supported databases include SQLite, MySQL, Microsoft SQL Server, and Postgres.
 
If sensitive values (like private keys) should be stored in an encrypted format, set the encryption_passphrase option.
 
debug
 
     
  • Default: false
    •  
  • Description: If true, logs all database statements (verbose).
    •  
 
slow_query_threshold
 
     
  • Default: 0
    •  
  • Description: A time threshold (e.g., 100ms) above which queries are considered slow and logged as warnings. If empty or zero, slow query logging is disabled. Format uses s, ms for seconds, milliseconds, see time.ParseDuration.
    •  
 
type
 
     
  • Default: sqlite
    •  
  • Description: The database type. Valid options: sqlite, mssql, mysql, postgres.
    •  
 
dsn
 
     
  • Default: data/sqlite.db
    •  
  • Description: The Data Source Name (DSN) for connecting to the database.
     For example: 
    user:pass@tcp(1.2.3.4:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local
+
     
 
Below you will find sections like core, advanced, database, statistics, mail, auth, web and webhook.
 Each section describes the individual configuration keys, their default values, and a brief explanation of their purpose.
 
 
Core
 
These are the primary configuration options that control fundamental WireGuard Portal behavior. More advanced options are found in the subsequent Advanced section.
 
admin_user
 
     
  • Default: admin@wgportal.local
    •  
  • Description: The administrator user. This user will be created as a default admin if it does not yet exist.
    •  
 
admin_password
 
     
  • Default: wgportal
    •  
  • Description: The administrator password. The default password of wgportal should be changed immediately.
    •  
 
admin_api_token
 
     
  • Default: (empty)
    •  
  • Description: An API token for the admin user. If a token is provided, the REST API can be accessed using this token. If empty, the API is initially disabled for the admin user.
    •  
 
editable_keys
 
     
  • Default: true
    •  
  • Description: Allow editing of WireGuard key-pairs directly in the UI.
    •  
 
create_default_peer
 
     
  • Default: false
    •  
  • Description: If a user logs in for the first time with no existing peers, automatically create a new WireGuard peer for all server interfaces.
    •  
 
create_default_peer_on_creation
 
     
  • Default: false
    •  
  • Description: If an LDAP user is created (e.g., through LDAP sync) and has no peers, automatically create a new WireGuard peer for all server interfaces.
    •  
 
re_enable_peer_after_user_enable
 
     
  • Default: true
    •  
  • Description: Re-enable all peers that were previously disabled if the associated user is re-enabled.
    •  
 
delete_peer_after_user_deleted
 
     
  • Default: false
    •  
  • Description: If a user is deleted, remove all linked peers. Otherwise, peers remain but are disabled.
    •  
 
self_provisioning_allowed
 
     
  • Default: false
    •  
  • Description: Allow registered (non-admin) users to self-provision peers from their profile page.
    •  
 
import_existing
 
     
  • Default: true
    •  
  • Description: On startup, import existing WireGuard interfaces and peers into WireGuard Portal.
    •  
 
restore_state
 
     
  • Default: true
    •  
  • Description: Restore the WireGuard interface states (up/down) that existed before WireGuard Portal started.
    •  
 
 
Advanced
 
Additional or more specialized configuration options for logging and interface creation details.
 
log_level
 
     
  • Default: info
    •  
  • Description: The log level used by the application. Valid options are: trace, debug, info, warn, error.
    •  
 
log_pretty
 
     
  • Default: false
    •  
  • Description: If true, log messages are colorized and formatted for readability (pretty-print).
    •  
 
log_json
 
     
  • Default: false
    •  
  • Description: If true, log messages are structured in JSON format.
    •  
 
start_listen_port
 
     
  • Default: 51820
    •  
  • Description: The first port to use when automatically creating new WireGuard interfaces.
    •  
 
start_cidr_v4
 
     
  • Default: 10.11.12.0/24
    •  
  • Description: The initial IPv4 subnet to use when automatically creating new WireGuard interfaces.
    •  
 
start_cidr_v6
 
     
  • Default: fdfd:d3ad:c0de:1234::0/64
    •  
  • Description: The initial IPv6 subnet to use when automatically creating new WireGuard interfaces.
    •  
 
use_ip_v6
 
     
  • Default: true
    •  
  • Description: Enable or disable IPv6 support.
    •  
 
config_storage_path
 
     
  • Default: (empty)
    •  
  • Description: Path to a directory where wg-quick style configuration files will be stored (if you need local filesystem configs).
    •  
 
expiry_check_interval
 
     
  • Default: 15m
    •  
  • Description: Interval after which existing peers are checked if they are expired. Format uses s, m, h, d for seconds, minutes, hours, days, see time.ParseDuration.
    •  
 
rule_prio_offset
 
     
  • Default: 20000
    •  
  • Description: Offset for IP route rule priorities when configuring routing.
    •  
 
route_table_offset
 
     
  • Default: 20000
    •  
  • Description: Offset for IP route table IDs when configuring routing.
    •  
 
api_admin_only
 
     
  • Default: true
    •  
  • Description: If true, the public REST API is accessible only to admin users. The API docs live at /api/v1/doc.html.
    •  
 
 
Database
 
Configuration for the underlying database used by WireGuard Portal. Supported databases include SQLite, MySQL, Microsoft SQL Server, and Postgres.
 
If sensitive values (like private keys) should be stored in an encrypted format, set the encryption_passphrase option.
 
debug
 
     
  • Default: false
    •  
  • Description: If true, logs all database statements (verbose).
    •  
 
slow_query_threshold
 
     
  • Default: "0"
    •  
  • Description: A time threshold (e.g., 100ms) above which queries are considered slow and logged as warnings. If zero, slow query logging is disabled. Format uses s, ms for seconds, milliseconds, see time.ParseDuration. The value must be a string.
    •  
 
type
 
     
  • Default: sqlite
    •  
  • Description: The database type. Valid options: sqlite, mssql, mysql, postgres.
    •  
 
dsn
 
     
  • Default: data/sqlite.db
    •  
  • Description: The Data Source Name (DSN) for connecting to the database.
     For example: 
    user:pass@tcp(1.2.3.4:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local
 
    •  
 
encryption_passphrase
 
     
  • Default: (empty)
    •  
  • Description: Passphrase for encrypting sensitive values such as private keys in the database. Encryption is only applied if this passphrase is set. Important: Once you enable encryption by setting this passphrase, you cannot disable it or change it afterward. New or updated records will be encrypted; existing data remains in plaintext until it’s next modified.
    •  
 
 
Statistics
 
Controls how WireGuard Portal collects and reports usage statistics, including ping checks and Prometheus metrics.
 
use_ping_checks
 
     
  • Default: true
    •  
  • Description: Enable periodic ping checks to verify that peers remain responsive.
    •  
 
ping_check_workers
 
     
  • Default: 10
    •  
  • Description: Number of parallel worker processes for ping checks.
    •  
 
ping_unprivileged
 
     
  • Default: false
    •  
  • Description: If false, ping checks run without root privileges. This is currently considered BETA.
    •  
 
ping_check_interval
 
     
  • Default: 1m
    •  
  • Description: Interval between consecutive ping checks for all peers. Format uses s, m, h, d for seconds, minutes, hours, days, see time.ParseDuration.
    •  
 
data_collection_interval
 
     
  • Default: 1m
    •  
  • Description: Interval between data collection cycles (bytes sent/received, handshake times, etc.). Format uses s, m, h, d for seconds, minutes, hours, days, see time.ParseDuration.
    •  
 
collect_interface_data
 
     
  • Default: true
    •  
  • Description: If true, collects interface-level data (bytes in/out) for monitoring and statistics.
    •  
 
collect_peer_data
 
     
  • Default: true
    •  
  • Description: If true, collects peer-level data (bytes, last handshake, endpoint, etc.).
    •  
 
collect_audit_data
 
     
  • Default: true
    •  
  • Description: If true, logs certain portal events (such as user logins) to the database.
    •  
 
listening_address
 
     
  • Default: :8787
    •  
  • Description: Address and port for the integrated Prometheus metric server (e.g., :8787).
    •  
 
 
Mail
 
Options for configuring email notifications or sending peer configurations via email.
 
host
 
     
  • Default: 127.0.0.1
    •  
  • Description: Hostname or IP of the SMTP server.
    •  
 
port
 
     
  • Default: 25
    •  
  • Description: Port number for the SMTP server.
    •  
 
encryption
 
     
  • Default: none
    •  
  • Description: SMTP encryption type. Valid values: none, tls, starttls.
    •  
 
cert_validation
 
     
  • Default: true
    •  
  • Description: If true, validate the SMTP server certificate (relevant if encryption = tls).
    •  
 
username
 
     
  • Default: (empty)
    •  
  • Description: Optional SMTP username for authentication.
    •  
 
password
 
     
  • Default: (empty)
    •  
  • Description: Optional SMTP password for authentication.
    •  
 
auth_type
 
     
  • Default: plain
    •  
  • Description: SMTP authentication type. Valid values: plain, login, crammd5.
    •  
 
from
 
     
  • Default: Wireguard Portal <noreply@wireguard.local>
    •  
  • Description: The default "From" address when sending emails.
    •  
  
     
  • Default: false
    •  
  • Description: If true, emails only contain a link to WireGuard Portal, rather than attaching the full configuration.
    •  
 
 
Auth
 
WireGuard Portal supports multiple authentication strategies, including OpenID Connect (oidc), OAuth (oauth), and LDAP (ldap). Each can have multiple providers configured. Below are the relevant keys.
 
 
OIDC
 
The oidc array contains a list of OpenID Connect providers. Below are the properties for each OIDC provider entry inside auth.oidc:
 
provider_name
 
     
  • Default: (empty)
    •  
  • Description: A unique name for this provider. Must not conflict with other providers.
    •  
 
display_name
 
     
  • Default: (empty)
    •  
  • Description: A user-friendly name shown on the login page (e.g., "Login with Google").
    •  
 
base_url
 
     
  • Default: (empty)
    •  
  • Description: The OIDC provider’s base URL (e.g., https://accounts.google.com).
    •  
 
client_id
 
     
  • Default: (empty)
    •  
  • Description: The OAuth client ID from the OIDC provider.
    •  
 
client_secret
 
     
  • Default: (empty)
    •  
  • Description: The OAuth client secret from the OIDC provider.
    •  
 
extra_scopes
 
     
  • Default: (empty)
    •  
  • Description: A list of additional OIDC scopes (e.g., profile, email).
    •  
 
field_map
 
     
  • Default: (empty)
    •  
  • Description: Maps OIDC claims to WireGuard Portal user fields. 
    •  
  •  
    Available fields: user_identifier, email, firstname, lastname, phone, department, is_admin, user_groups.
     
      
     Field Typical OIDC Claim Explanation 
           
     user_identifier sub or preferred_username A unique identifier for the user. Often the OIDC sub claim is used because it’s guaranteed to be unique for the user within the IdP. Some providers also support preferred_username if it’s unique. 
     
     email email The user’s email address as provided by the IdP. Not always verified, depending on IdP settings. 
     
     firstname given_name The user’s first name, typically provided by the IdP in the given_name claim. 
     
     lastname family_name The user’s last (family) name, typically provided by the IdP in the family_name claim. 
     
     phone phone_number The user’s phone number. This may require additional scopes/permissions from the IdP to access. 
     
     department Custom claim (e.g., department) If the IdP can provide organizational data, it may store it in a custom claim. Adjust accordingly (e.g., department, org, or another attribute). 
     
     is_admin Custom claim or derived role If the IdP returns a role or admin flag, you can map that to is_admin. Often this is managed through custom claims or group membership. 
     
     user_groups groups or another custom claim A list of group memberships for the user. Some IdPs provide groups out of the box; others require custom claims or directory lookups. 
          
     
    •  
 
admin_mapping
 
     
  • Default: (empty)
    •  
  • Description: WgPortal can grant a user admin rights by matching the value of the is_admin claim against a regular expression. Alternatively, a regular expression can be used to check if a user is member of a specific group listed in the user_group claim. The regular expressions are defined in admin_value_regex and admin_group_regex.
       
    • admin_value_regex: A regular expression to match the is_admin claim. By default, this expression matches the string "true" (^true$).
      •  
    • admin_group_regex: A regular expression to match the user_groups claim. Each entry in the user_groups claim is checked against this regex.
      •  
     
    •  
 
registration_enabled
 
     
  • Default: (empty)
    •  
  • Description: If true, a new user will be created in WireGuard Portal if not already present.
    •  
 
log_user_info
 
     
  • Default: (empty)
    •  
  • Description: If true, OIDC user data is logged at the trace level upon login (for debugging).
    •  
 
 
OAuth
 
The oauth array contains a list of plain OAuth2 providers. Below are the properties for each OAuth provider entry inside auth.oauth:
 
provider_name
 
     
  • Default: (empty)
    •  
  • Description: A unique name for this provider. Must not conflict with other providers.
    •  
 
display_name
 
     
  • Default: (empty)
    •  
  • Description: A user-friendly name shown on the login page.
    •  
 
client_id
 
     
  • Default: (empty)
    •  
  • Description: The OAuth client ID for the provider.
    •  
 
client_secret
 
     
  • Default: (empty)
    •  
  • Description: The OAuth client secret for the provider.
    •  
 
auth_url
 
     
  • Default: (empty)
    •  
  • Description: URL of the authentication endpoint.
    •  
 
token_url
 
     
  • Default: (empty)
    •  
  • Description: URL of the token endpoint.
    •  
 
user_info_url
 
     
  • Default: (empty)
    •  
  • Description: URL of the user information endpoint.
    •  
 
scopes
 
     
  • Default: (empty)
    •  
  • Description: A list of OAuth scopes.
    •  
 
field_map
 
     
  • Default: (empty)
    •  
  • Description: Maps OAuth attributes to WireGuard Portal fields.
    •  
  •  
    Available fields: user_identifier, email, firstname, lastname, phone, department, is_admin, user_groups.
     
      
     Field Typical Claim Explanation 
           
     user_identifier sub or preferred_username A unique identifier for the user. Often the OIDC sub claim is used because it’s guaranteed to be unique for the user within the IdP. Some providers also support preferred_username if it’s unique. 
     
     email email The user’s email address as provided by the IdP. Not always verified, depending on IdP settings. 
     
     firstname given_name The user’s first name, typically provided by the IdP in the given_name claim. 
     
     lastname family_name The user’s last (family) name, typically provided by the IdP in the family_name claim. 
     
     phone phone_number The user’s phone number. This may require additional scopes/permissions from the IdP to access. 
     
     department Custom claim (e.g., department) If the IdP can provide organizational data, it may store it in a custom claim. Adjust accordingly (e.g., department, org, or another attribute). 
     
     is_admin Custom claim or derived role If the IdP returns a role or admin flag, you can map that to is_admin. Often this is managed through custom claims or group membership. 
     
     user_groups groups or another custom claim A list of group memberships for the user. Some IdPs provide groups out of the box; others require custom claims or directory lookups. 
          
     
    •  
 
admin_mapping
 
     
  • Default: (empty)
    •  
  • Description: WgPortal can grant a user admin rights by matching the value of the is_admin claim against a regular expression. Alternatively, a regular expression can be used to check if a user is member of a specific group listed in the user_group claim. The regular expressions are defined in admin_value_regex and admin_group_regex.
    •  
  • admin_value_regex: A regular expression to match the is_admin claim. By default, this expression matches the string "true" (^true$).
    •  
  • admin_group_regex: A regular expression to match the user_groups claim. Each entry in the user_groups claim is checked against this regex.
    •  
 
registration_enabled
 
     
  • Default: (empty)
    •  
  • Description: If true, new users are created automatically on successful login.
    •  
 
log_user_info
 
     
  • Default: (empty)
    •  
  • Description: If true, logs user info at the trace level upon login.
    •  
 
 
LDAP
 
The ldap array contains a list of LDAP authentication providers. Below are the properties for each LDAP provider entry inside auth.ldap:
 
provider_name
 
     
  • Default: (empty)
    •  
  • Description: A unique name for this provider. Must not conflict with other providers.
    •  
 
url
 
     
  • Default: (empty)
    •  
  • Description: The LDAP server URL (e.g., ldap://srv-ad01.company.local:389).
    •  
 
start_tls
 
     
  • Default: (empty)
    •  
  • Description: If true, use STARTTLS to secure the LDAP connection.
    •  
 
cert_validation
 
     
  • Default: (empty)
    •  
  • Description: If true, validate the LDAP server’s TLS certificate.
    •  
 
tls_certificate_path
 
     
  • Default: (empty)
    •  
  • Description: Path to a TLS certificate if needed for LDAP connections.
    •  
 
tls_key_path
 
     
  • Default: (empty)
    •  
  • Description: Path to the corresponding TLS certificate key.
    •  
 
base_dn
 
     
  • Default: (empty)
    •  
  • Description: The base DN for user searches (e.g., DC=COMPANY,DC=LOCAL).
    •  
 
bind_user
 
     
  • Default: (empty)
    •  
  • Description: The bind user for LDAP (e.g., company\\ldap_wireguard or ldap_wireguard@company.local).
    •  
 
bind_pass
 
     
  • Default: (empty)
    •  
  • Description: The bind password for LDAP authentication.
    •  
 
field_map
 
     
  • Default: (empty)
    •  
  •  
    Description: Maps LDAP attributes to WireGuard Portal fields.
     
       
    • Available fields: user_identifier, email, firstname, lastname, phone, department, memberof.
      •  
     
      
     WireGuard Portal Field Typical LDAP Attribute Short Description 
           
     user_identifier sAMAccountName / uid Uniquely identifies the user within the LDAP directory. 
     
     email mail / userPrincipalName Stores the user's primary email address. 
     
     firstname givenName Contains the user's first (given) name. 
     
     lastname sn Contains the user's last (surname) name. 
     
     phone telephoneNumber / mobile Holds the user's phone or mobile number. 
     
     department departmentNumber / ou Specifies the department or organizational unit of the user. 
     
     memberof memberOf Lists the groups and roles to which the user belongs. 
          
     
    •  
 
login_filter
 
     
  • Default: (empty)
    •  
  • Description: An LDAP filter to restrict which users can log in. Use {{login_identifier}} to insert the username. For example: 
    (&(objectClass=organizationalPerson)(mail={{login_identifier}})(!userAccountControl:1.2.840.113556.1.4.803:=2))
 
    •  
 
admin_group
 
     
  • Default: (empty)
    •  
  • Description: A specific LDAP group whose members are considered administrators in WireGuard Portal. For example: 
    CN=WireGuardAdmins,OU=Some-OU,DC=YOURDOMAIN,DC=LOCAL
 
    •  
 
sync_interval
 
     
  • Default: (empty)
    •  
  • Description: How frequently (in duration, e.g. 30m) to synchronize users from LDAP. Empty or 0 disables sync. Format uses s, m, h, d for seconds, minutes, hours, days, see time.ParseDuration. Only users that match the sync_filter are synchronized, if disable_missing is true, users not found in LDAP are disabled.
    •  
 
sync_filter
 
     
  • Default: (empty)
    •  
  • Description: An LDAP filter to select which users get synchronized into WireGuard Portal. For example: 
    (&(objectClass=organizationalPerson)(!userAccountControl:1.2.840.113556.1.4.803:=2)(mail=*))
diff --git a/master/documentation/getting-started/binaries/index.html b/master/documentation/getting-started/binaries/index.html
index a579672..52fc276 100644
--- a/master/documentation/getting-started/binaries/index.html
+++ b/master/documentation/getting-started/binaries/index.html
@@ -1,4 +1,4 @@
- Binaries - WireGuard Portal      
     
      
      
     
      
     
     
     
     
      
     
     
     
     
     
      
     
     
     
     
     
    Binaries
     
    Starting from v2, each release includes compiled binaries for supported platforms. These binary versions can be manually downloaded and installed.
     
    Download
     
    With curl:
     
    curl -L -o wg-portal https://github.com/h44z/wg-portal/releases/download/${WG_PORTAL_VERSION}/wg-portal_linux_amd64 
+ Binaries - WireGuard Portal      
     
      
      
     
      
     
     
     
     
      
     
     
     
     
     
      
     
     
     
     
     
    Binaries
     
    Starting from v2, each release includes compiled binaries for supported platforms. These binary versions can be manually downloaded and installed.
     
    Download
     
    With curl:
     
    curl -L -o wg-portal https://github.com/h44z/wg-portal/releases/download/${WG_PORTAL_VERSION}/wg-portal_linux_amd64 
 
     
    With wget:
     
    wget -O wg-portal https://github.com/h44z/wg-portal/releases/download/${WG_PORTAL_VERSION}/wg-portal_linux_amd64
 
     
    with gh cli:
     
    gh release download ${WG_PORTAL_VERSION} --repo h44z/wg-portal --output wg-portal --pattern '*amd64'
 
     
    Install
     
    sudo mkdir -p /opt/wg-portal
diff --git a/master/documentation/getting-started/docker/index.html b/master/documentation/getting-started/docker/index.html
index 4afb8ce..e734dad 100644
--- a/master/documentation/getting-started/docker/index.html
+++ b/master/documentation/getting-started/docker/index.html
@@ -1,4 +1,4 @@
- Docker - WireGuard Portal      
     
      
      
     
      
     
     
     
     
      
     
     
     
     
     
      
     
     
     
     
     
    Docker
     
    Image Usage
     
    The WireGuard Portal Docker image is available on both Docker Hub and GitHub Container Registry. It is built on the official Alpine Linux base image and comes pre-packaged with all necessary WireGuard dependencies.
     
    This container allows you to establish WireGuard VPN connections without relying on a host system that supports WireGuard or using the linuxserver/wireguard Docker image.
     
    The recommended method for deploying WireGuard Portal is via Docker Compose for ease of configuration and management.
     
    A sample docker-compose.yml (managing WireGuard interfaces directly on the host) is provided below:
     
    ---
+ Docker - WireGuard Portal      
     
      
      
     
      
     
     
     
     
      
     
     
     
     
     
      
     
     
     
     
     
    Docker
     
    Image Usage
     
    The WireGuard Portal Docker image is available on both Docker Hub and GitHub Container Registry. It is built on the official Alpine Linux base image and comes pre-packaged with all necessary WireGuard dependencies.
     
    This container allows you to establish WireGuard VPN connections without relying on a host system that supports WireGuard or using the linuxserver/wireguard Docker image.
     
    The recommended method for deploying WireGuard Portal is via Docker Compose for ease of configuration and management.
     
    A sample docker-compose.yml (managing WireGuard interfaces directly on the host) is provided below:
     
    ---
 services:
   wg-portal:
     image: wgportal/wg-portal:latest
@@ -12,9 +12,9 @@
       - NET_ADMIN
     network_mode: "host"
     volumes:
+      # left side is the host path, right side is the container path
       - /etc/wireguard:/etc/wireguard
       - ./data:/app/data
-      - ./config:/app/config
 
     
    By default, the webserver is listening on port 8888.
     
    Volumes for /app/data and /app/config should be used ensure data persistence across container restarts.
     
    WireGuard Interface Handling
     
    WireGuard Portal supports managing WireGuard interfaces through three distinct deployment methods, providing flexibility based on your system architecture and operational preferences:
     
       
    •  
      Directly on the host system: WireGuard Portal can control WireGuard interfaces natively on the host, without using containers. This setup is ideal for environments where direct access to system networking is preferred. To use this method, you need to set the network mode to host in your docker-compose.yml file. 
      services:
   wg-portal:
     ...
@@ -28,6 +28,7 @@
     cap_add:
       - NET_ADMIN
     ports:
+      # host port : container port
       # WireGuard port, needs to match the port in wg-portal interface config (add one port mapping for each interface)
       - "51820:51820/udp" 
       # Web UI port
@@ -35,6 +36,7 @@
     sysctls:
       - net.ipv4.conf.all.src_valid_mark=1
     volumes:
+      # host path : container path
       - ./wg/data:/app/data
       - ./wg/config:/app/config
 
       
      •  
    •  
      Via a separate Docker container: WireGuard Portal can interface with and control WireGuard running in another Docker container, such as the linuxserver/wireguard image. This method is useful in setups that already use linuxserver/wireguard or where you want to isolate the VPN backend from the portal frontend. For this, you need to set the network mode to service:wireguard in your docker-compose.yml file, wireguard is the service name of your WireGuard container. 
      services:
@@ -46,6 +48,7 @@
       - NET_ADMIN
     network_mode: "service:wireguard" # So we ensure to stay on the same network as the wireguard container.
     volumes:
+      # host path : container path
       - ./wg/etc:/etc/wireguard
       - ./wg/data:/app/data
       - ./wg/config:/app/config
@@ -57,6 +60,7 @@
     cap_add:
       - NET_ADMIN
     ports:
+      # host port : container port
       - "51820:51820/udp" # WireGuard port, needs to match the port in wg-portal interface config
       - "8888:8888/tcp" # Noticed that the port of the web UI is exposed in the wireguard container.
     volumes:
@@ -72,6 +76,6 @@
 advanced:
   # WireGuard Portal needs to export the WireGuard configuration as wg-quick config files so that the WireGuard container can use them.
   config_storage_path: /etc/wireguard/
-
       
      •  
     
    Image Versioning
     
    All images are hosted on Docker Hub at https://hub.docker.com/r/wgportal/wg-portal or in the GitHub Container Registry. There are three types of tags in the repository:
     
    Semantic versioned tags
     
    For example, 2.0.0-rc.1 or v2.0.0-rc.1.
     
    These are official releases of WireGuard Portal. They correspond to the GitHub tags that we make, and you can see the release notes for them here: https://github.com/h44z/wg-portal/releases.
     
    Once these tags show up in this repository, they will never change.
     
    For production deployments of WireGuard Portal, we strongly recommend using one of these tags, e.g. wgportal/wg-portal:1.0.19, instead of the latest or canary tags.
     
    If you only want to stay at the same major or major+minor version, use either v[MAJOR] or [MAJOR].[MINOR] tags. For example v1 or 1.0.
     
    Version 1 is currently stable, version 2 is in development.
     
    latest
     
    This is the most recent build to master! It changes a lot and is very unstable.
     
    We recommend that you don't use it except for development purposes.
     
    Branch tags
     
    For each commit in the master and the stable branch, a corresponding Docker image is build. These images use the master or stable tags.
     
    Configuration
     
    You can configure WireGuard Portal using a YAML configuration file. The filepath of the YAML configuration file defaults to /app/config/config.yml. It is possible to override the configuration filepath using the environment variable WG_PORTAL_CONFIG.
     
    By default, WireGuard Portal uses an SQLite database. The database is stored in /app/data/sqlite.db.
     
    You should mount those directories as a volume:
     
       
    • /app/data
      •  
    • /app/config
      •  
     
    A detailed description of the configuration options can be found here.
     
    If you want to access configuration files in wg-quick format, you can mount the /etc/wireguard directory to a location of your choice. Also enable the config_storage_path option in the configuration file: 
    advanced:
+
     
    •  
 
Image Versioning
 
All images are hosted on Docker Hub at https://hub.docker.com/r/wgportal/wg-portal or in the GitHub Container Registry. There are three types of tags in the repository:
 
Semantic versioned tags
 
For example, 2.0.0-rc.1 or v2.0.0-rc.1.
 
These are official releases of WireGuard Portal. They correspond to the GitHub tags that we make, and you can see the release notes for them here: https://github.com/h44z/wg-portal/releases.
 
Once these tags show up in this repository, they will never change.
 
For production deployments of WireGuard Portal, we strongly recommend using one of these tags, e.g. wgportal/wg-portal:1.0.19, instead of the latest or canary tags.
 
If you only want to stay at the same major or major+minor version, use either v[MAJOR] or [MAJOR].[MINOR] tags. For example v1 or 1.0.
 
Version 1 is currently stable, version 2 is in development.
 
latest
 
This is the most recent build to master! It changes a lot and is very unstable.
 
We recommend that you don't use it except for development purposes.
 
Branch tags
 
For each commit in the master and the stable branch, a corresponding Docker image is build. These images use the master or stable tags.
 
Configuration
 
You can configure WireGuard Portal using a YAML configuration file. The filepath of the YAML configuration file defaults to /app/config/config.yaml. It is possible to override the configuration filepath using the environment variable WG_PORTAL_CONFIG.
 
By default, WireGuard Portal uses an SQLite database. The database is stored in /app/data/sqlite.db.
 
You should mount those directories as a volume:
 
     
  • /app/data
    •  
  • /app/config
    •  
 
A detailed description of the configuration options can be found here.
 
If you want to access configuration files in wg-quick format, you can mount the /etc/wireguard directory to a location of your choice. Also enable the config_storage_path option in the configuration file: 
advanced:
   config_storage_path: /etc/wireguard
 
 
 
  
 
   
 
 
 
    
\ No newline at end of file
diff --git a/master/documentation/getting-started/helm/index.html b/master/documentation/getting-started/helm/index.html
index 3f93c32..b24fa94 100644
--- a/master/documentation/getting-started/helm/index.html
+++ b/master/documentation/getting-started/helm/index.html
@@ -1,2 +1,2 @@
- Helm - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Helm
 
Installing the Chart
 
To install the chart with the release name wg-portal:
 
helm install wg-portal oci://ghcr.io/h44z/charts/wg-portal
+ Helm - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Helm
 
Installing the Chart
 
To install the chart with the release name wg-portal:
 
helm install wg-portal oci://ghcr.io/h44z/charts/wg-portal
 
 
This command deploy wg-portal on the Kubernetes cluster in the default configuration. The Values section lists the parameters that can be configured during installation.
 
Values
 
  
 Key Type Default Description 
   
 nameOverride string "" Partially override resource names (adds suffix) 
 
 fullnameOverride string "" Fully override resource names 
 
 extraDeploy list [] Array of extra objects to deploy with the release 
 
 config.advanced tpl/object {} Advanced configuration options. 
 
 config.auth tpl/object {} Auth configuration options. 
 
 config.core tpl/object {} Core configuration options.
 If external admins in auth are defined and there are no admin_user and admin_password defined here, the default admin account will be disabled.		 
 
 config.database tpl/object {} Database configuration options 
 
 config.mail tpl/object {} Mail configuration options 
 
 config.statistics tpl/object {} Statistics configuration options 
 
 config.web tpl/object {} Web configuration options.
 listening_address will be set automatically from service.web.port. external_url is required to enable ingress and certificate resources.		 
 
 revisionHistoryLimit string 10 The number of old ReplicaSets to retain to allow rollback. 
 
 workloadType string "Deployment" Workload type - Deployment or StatefulSet 
 
 strategy object {"type":"RollingUpdate"} Update strategy for the workload Valid values are: RollingUpdate or Recreate for Deployment, RollingUpdate or OnDelete for StatefulSet 
 
 image.repository string "ghcr.io/h44z/wg-portal" Image repository 
 
 image.pullPolicy string "IfNotPresent" Image pull policy 
 
 image.tag string "" Overrides the image tag whose default is the chart appVersion 
 
 imagePullSecrets list [] Image pull secrets 
 
 podAnnotations tpl/object {} Extra annotations to add to the pod 
 
 podLabels object {} Extra labels to add to the pod 
 
 podSecurityContext object {} Pod Security Context 
 
 securityContext.capabilities.add list ["NET_ADMIN"] Add capabilities to the container 
 
 initContainers tpl/list [] Pod init containers 
 
 sidecarContainers tpl/list [] Pod sidecar containers 
 
 dnsPolicy string "ClusterFirst" Set DNS policy for the pod. Valid values are ClusterFirstWithHostNet, ClusterFirst, Default or None. 
 
 restartPolicy string "Always" Restart policy for all containers within the pod. Valid values are Always, OnFailure or Never. 
 
 hostNetwork string false. Use the host's network namespace. 
 
 resources object {} Resources requests and limits 
 
 command list [] Overwrite pod command 
 
 args list [] Additional pod arguments 
 
 env tpl/list [] Additional environment variables 
 
 envFrom tpl/list [] Additional environment variables from a secret or configMap 
 
 livenessProbe object {} Liveness probe configuration 
 
 readinessProbe object {} Readiness probe configuration 
 
 startupProbe object {} Startup probe configuration 
 
 volumes tpl/list [] Additional volumes 
 
 volumeMounts tpl/list [] Additional volumeMounts 
 
 nodeSelector object {"kubernetes.io/os":"linux"} Node Selector configuration 
 
 tolerations list [] Tolerations configuration 
 
 affinity object {} Affinity configuration 
 
 service.mixed.enabled bool false Whether to create a single service for the web and wireguard interfaces 
 
 service.mixed.type string "LoadBalancer" Service type 
 
 service.web.annotations object {} Annotations for the web service 
 
 service.web.type string "ClusterIP" Web service type 
 
 service.web.port int 8888 Web service port Used for the web interface listener 
 
 service.web.appProtocol string "http" Web service appProtocol. Will be auto set to https if certificate is enabled. 
 
 service.wireguard.annotations object {} Annotations for the WireGuard service 
 
 service.wireguard.type string "LoadBalancer" Wireguard service type 
 
 service.wireguard.ports list [51820] Wireguard service ports. Exposes the WireGuard ports for created interfaces. Lowerest port is selected as start port for the first interface. Increment next port by 1 for each additional interface. 
 
 service.metrics.port int 8787  
 
 ingress.enabled bool false Specifies whether an ingress resource should be created 
 
 ingress.className string "" Ingress class name 
 
 ingress.annotations object {} Ingress annotations 
 
 ingress.tls bool false Ingress TLS configuration. Enable certificate resource or add ingress annotation to create required secret 
 
 certificate.enabled bool false Specifies whether a certificate resource should be created. If enabled, certificate will be used for the web. 
 
 certificate.issuer.name string "" Certificate issuer name 
 
 certificate.issuer.kind string "" Certificate issuer kind (ClusterIssuer or Issuer) 
 
 certificate.issuer.group string "cert-manager.io" Certificate issuer group 
 
 certificate.duration string "" Optional. Documentation 
 
 certificate.renewBefore string "" Optional. Documentation 
 
 certificate.commonName string "" Optional. Documentation 
 
 certificate.emailAddresses list [] Optional. Documentation 
 
 certificate.ipAddresses list [] Optional. Documentation 
 
 certificate.keystores object {} Optional. Documentation 
 
 certificate.privateKey object {} Optional. Documentation 
 
 certificate.secretTemplate object {} Optional. Documentation 
 
 certificate.subject object {} Optional. Documentation 
 
 certificate.uris list [] Optional. Documentation 
 
 certificate.usages list [] Optional. Documentation 
 
 persistence.enabled bool false Specifies whether an persistent volume should be created 
 
 persistence.annotations object {} Persistent Volume Claim annotations 
 
 persistence.storageClass string "" Persistent Volume storage class. If undefined (the default) cluster's default provisioner will be used. 
 
 persistence.accessMode string "ReadWriteOnce" Persistent Volume Access Mode 
 
 persistence.size string "1Gi" Persistent Volume size 
 
 persistence.volumeName string "" Persistent Volume Name (optional) 
 
 serviceAccount.create bool true Specifies whether a service account should be created 
 
 serviceAccount.annotations object {} Service account annotations 
 
 serviceAccount.automount bool false Automatically mount a ServiceAccount's API credentials 
 
 serviceAccount.name string "" The name of the service account to use. If not set and create is true, a name is generated using the fullname template 
 
 monitoring.enabled bool false Enable Prometheus monitoring. 
 
 monitoring.apiVersion string "monitoring.coreos.com/v1" API version of the Prometheus resource. Use azmonitoring.coreos.com/v1 for Azure Managed Prometheus. 
 
 monitoring.kind string "PodMonitor" Kind of the Prometheus resource. Could be PodMonitor or ServiceMonitor. 
 
 monitoring.labels object {} Resource labels. 
 
 monitoring.annotations object {} Resource annotations. 
 
 monitoring.interval string 1m Interval at which metrics should be scraped. If not specified config.statistics.data_collection_interval interval is used. 
 
 monitoring.metricRelabelings list [] Relabelings to samples before ingestion. 
 
 monitoring.relabelings list [] Relabelings to samples before scraping. 
 
 monitoring.scrapeTimeout string "" Timeout after which the scrape is ended If not specified, the Prometheus global scrape interval is used. 
 
 monitoring.jobLabel string "" The label to use to retrieve the job name from. 
 
 monitoring.podTargetLabels object {} Transfers labels on the Kubernetes Pod onto the target. 
 
 monitoring.dashboard.enabled bool false Enable Grafana dashboard. 
 
 monitoring.dashboard.annotations object {} Annotations for the dashboard ConfigMap. 
 
 monitoring.dashboard.labels object {} Additional labels for the dashboard ConfigMap. 
 
 monitoring.dashboard.namespace string "" Dashboard ConfigMap namespace Overrides the namespace for the dashboard ConfigMap. 
  
 
 
  
 
   
 
 
 
    
\ No newline at end of file
diff --git a/master/documentation/getting-started/reverse-proxy/index.html b/master/documentation/getting-started/reverse-proxy/index.html
new file mode 100644
index 0000000..94a7eee
--- /dev/null
+++ b/master/documentation/getting-started/reverse-proxy/index.html
@@ -0,0 +1,69 @@
+ Reverse Proxy (HTTPS) - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Reverse Proxy (HTTPS)
 
Reverse Proxy for HTTPS
 
For production deployments, always serve the WireGuard Portal over HTTPS. You have two options to secure your connection:
 
Reverse Proxy
 
Let a front‐end proxy handle HTTPS for you. This also frees you from managing certificates manually and is therefore the preferred option. You can use Nginx, Traefik, Caddy or any other proxy. 
 
Below is an example using a Docker Compose stack with Traefik. It exposes the WireGuard Portal on https://wg.domain.com and redirects initial HTTP traffic to HTTPS.
 
services:
+  reverse-proxy:
+    image: traefik:v3.3
+    restart: unless-stopped
+    command:
+      #- '--log.level=DEBUG'
+      - '--providers.docker.endpoint=unix:///var/run/docker.sock'
+      - '--providers.docker.exposedbydefault=false'
+      - '--entrypoints.web.address=:80'
+      - '--entrypoints.websecure.address=:443'
+      - '--entrypoints.websecure.http3'
+      - '--certificatesresolvers.letsencryptresolver.acme.httpchallenge=true'
+      - '--certificatesresolvers.letsencryptresolver.acme.httpchallenge.entrypoint=web'
+      - '--certificatesresolvers.letsencryptresolver.acme.email=your.email@domain.com'
+      - '--certificatesresolvers.letsencryptresolver.acme.storage=/letsencrypt/acme.json'
+      #- '--certificatesresolvers.letsencryptresolver.acme.caserver=https://acme-staging-v02.api.letsencrypt.org/directory'  # just for testing
+    ports:
+      - 80:80 # for HTTP
+      - 443:443/tcp  # for HTTPS
+      - 443:443/udp  # for HTTP/3
+    volumes:
+      - acme-certs:/letsencrypt
+      - /var/run/docker.sock:/var/run/docker.sock:ro
+    labels:
+      - 'traefik.enable=true'
+      # HTTP Catchall for redirecting HTTP -> HTTPS
+      - 'traefik.http.routers.dashboard-catchall.rule=Host(`wg.domain.com`) && PathPrefix(`/`)'
+      - 'traefik.http.routers.dashboard-catchall.entrypoints=web'
+      - 'traefik.http.routers.dashboard-catchall.middlewares=redirect-to-https'
+      - 'traefik.http.middlewares.redirect-to-https.redirectscheme.scheme=https'
+
+  wg-portal:
+    image: wgportal/wg-portal:latest
+    container_name: wg-portal
+    restart: unless-stopped
+    logging:
+      options:
+        max-size: "10m"
+        max-file: "3"
+    cap_add:
+      - NET_ADMIN
+    ports:
+      # host port : container port
+      # WireGuard port, needs to match the port in wg-portal interface config (add one port mapping for each interface)
+      - "51820:51820/udp"
+      # Web UI port (only available on localhost, Traefik will handle the HTTPS)
+      - "127.0.0.1:8888:8888/tcp"
+    sysctls:
+      - net.ipv4.conf.all.src_valid_mark=1
+    volumes:
+      # host path : container path
+      - ./wg/data:/app/data
+      - ./wg/config:/app/config
+    labels:
+      - 'traefik.enable=true'
+      - 'traefik.http.routers.wgportal.rule=Host(`wg.domain.com`)'
+      - 'traefik.http.routers.wgportal.entrypoints=websecure'
+      - 'traefik.http.routers.wgportal.tls.certresolver=letsencryptresolver'
+      - 'traefik.http.routers.wgportal.service=wgportal'
+      - 'traefik.http.services.wgportal.loadbalancer.server.port=8888'
+
+volumes:
+  acme-certs:
+
 
The WireGuard Portal configuration must be updated accordingly so that the correct external URL is set for the web interface:
 
web:
+  external_url: https://wg.domain.com
+
 
Built-in TLS
 
If you prefer to let WireGuard Portal handle TLS itself, you can use the built-in TLS support. In your config.yaml, under the web section, point to your certificate and key files:
 
web:
+  cert_file: /path/to/your/fullchain.pem
+  key_file:  /path/to/your/privkey.pem
+
 
The web server will then use these files to serve HTTPS traffic directly instead of HTTP.
 
 
  
 
   
 
 
 
    
\ No newline at end of file
diff --git a/master/documentation/getting-started/sources/index.html b/master/documentation/getting-started/sources/index.html
index 7f2a55d..69338a3 100644
--- a/master/documentation/getting-started/sources/index.html
+++ b/master/documentation/getting-started/sources/index.html
@@ -1,4 +1,4 @@
- Sources - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Sources
 
To build the application from source files, use the Makefile provided in the repository.
 
Requirements
  
Build
 
# Get source code
+ Sources - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Sources
 
To build the application from source files, use the Makefile provided in the repository.
 
Requirements
  
Build
 
# Get source code
 git clone https://github.com/h44z/wg-portal -b ${WG_PORTAL_VERSION:-master} --depth 1
 cd wg-portal
 # Build the frontend
diff --git a/master/documentation/monitoring/prometheus/index.html b/master/documentation/monitoring/prometheus/index.html
index b27f4f1..3136cd2 100644
--- a/master/documentation/monitoring/prometheus/index.html
+++ b/master/documentation/monitoring/prometheus/index.html
@@ -1,4 +1,4 @@
- Monitoring - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
By default, WG-Portal exposes Prometheus metrics on port 8787 if interface/peer statistic data collection is enabled.
 
Exposed Metrics
 
  
 Metric Type Description 
   
 wireguard_interface_received_bytes_total gauge Bytes received through the interface. 
 
 wireguard_interface_sent_bytes_total gauge Bytes sent through the interface. 
 
 wireguard_peer_last_handshake_seconds gauge Seconds from the last handshake with the peer. 
 
 wireguard_peer_received_bytes_total gauge Bytes received from the peer. 
 
 wireguard_peer_sent_bytes_total gauge Bytes sent to the peer. 
 
 wireguard_peer_up gauge Peer connection state (boolean: 1/0). 
  
 
Prometheus Config
 
Add following scrape job to your Prometheus config file:
 
# prometheus.yaml
+ Monitoring - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
By default, WG-Portal exposes Prometheus metrics on port 8787 if interface/peer statistic data collection is enabled.
 
Exposed Metrics
 
  
 Metric Type Description 
   
 wireguard_interface_received_bytes_total gauge Bytes received through the interface. 
 
 wireguard_interface_sent_bytes_total gauge Bytes sent through the interface. 
 
 wireguard_peer_last_handshake_seconds gauge Seconds from the last handshake with the peer. 
 
 wireguard_peer_received_bytes_total gauge Bytes received from the peer. 
 
 wireguard_peer_sent_bytes_total gauge Bytes sent to the peer. 
 
 wireguard_peer_up gauge Peer connection state (boolean: 1/0). 
  
 
Prometheus Config
 
Add following scrape job to your Prometheus config file:
 
# prometheus.yaml
 scrape_configs:
   - job_name: wg-portal
     scrape_interval: 60s
diff --git a/master/documentation/overview/index.html b/master/documentation/overview/index.html
index 97a6a59..543f10b 100644
--- a/master/documentation/overview/index.html
+++ b/master/documentation/overview/index.html
@@ -1 +1 @@
- Overview - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Overview
  
WireGuard Portal is a simple, web-based configuration portal for WireGuard server management. The portal uses the WireGuard wgctrl library to manage existing VPN interfaces. This allows for the seamless activation or deactivation of new users without disturbing existing VPN connections.
 
The configuration portal supports using a database (SQLite, MySQL, MsSQL or Postgres), OAuth or LDAP (Active Directory or OpenLDAP) as a user source for authentication and profile data.
 
Features
 
     
  • Self-hosted - the whole application is a single binary
    •  
  • Responsive multi-language web UI written in Vue.js
    •  
  • Automatically selects IP from the network pool assigned to the client
    •  
  • QR-Code for convenient mobile client configuration
    •  
  • Sends email to the client with QR-code and client config
    •  
  • Enable / Disable clients seamlessly
    •  
  • Generation of wg-quick configuration file (wgX.conf) if required
    •  
  • User authentication (database, OAuth, or LDAP)
    •  
  • IPv6 ready
    •  
  • Docker ready
    •  
  • Can be used with existing WireGuard setups
    •  
  • Support for multiple WireGuard interfaces
    •  
  • Peer Expiry Feature
    •  
  • Handles route and DNS settings like wg-quick does
    •  
  • Exposes Prometheus metrics for monitoring and alerting
    •  
  • REST API for management and client deployment
    •  
  • Webhook for custom actions on peer, interface or user updates
    •  
 
 
  
 
   
 
 
 
    
\ No newline at end of file
+ Overview - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Overview
  
WireGuard Portal is a simple, web-based configuration portal for WireGuard server management. The portal uses the WireGuard wgctrl library to manage existing VPN interfaces. This allows for the seamless activation or deactivation of new users without disturbing existing VPN connections.
 
The configuration portal supports using a database (SQLite, MySQL, MsSQL or Postgres), OAuth or LDAP (Active Directory or OpenLDAP) as a user source for authentication and profile data.
 
Features
 
     
  • Self-hosted - the whole application is a single binary
    •  
  • Responsive multi-language web UI written in Vue.js
    •  
  • Automatically selects IP from the network pool assigned to the client
    •  
  • QR-Code for convenient mobile client configuration
    •  
  • Sends email to the client with QR-code and client config
    •  
  • Enable / Disable clients seamlessly
    •  
  • Generation of wg-quick configuration file (wgX.conf) if required
    •  
  • User authentication (database, OAuth, or LDAP)
    •  
  • IPv6 ready
    •  
  • Docker ready
    •  
  • Can be used with existing WireGuard setups
    •  
  • Support for multiple WireGuard interfaces
    •  
  • Peer Expiry Feature
    •  
  • Handles route and DNS settings like wg-quick does
    •  
  • Exposes Prometheus metrics for monitoring and alerting
    •  
  • REST API for management and client deployment
    •  
  • Webhook for custom actions on peer, interface or user updates
    •  
 
 
  
 
   
 
 
 
    
\ No newline at end of file
diff --git a/master/documentation/rest-api/api-doc/index.html b/master/documentation/rest-api/api-doc/index.html
index de4fb06..abae0e9 100644
--- a/master/documentation/rest-api/api-doc/index.html
+++ b/master/documentation/rest-api/api-doc/index.html
@@ -1,5 +1,5 @@
 
- REST API - WireGuard Portal     
 
 
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
REST API
 
 
 
  
 
   
 
 
 
        
 
 
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
REST API
 
 
 
  
 
   
 
 
 
         
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Upgrade
 
For production deployments of WireGuard Portal, we strongly recommend using version 1. If you want to use version 2, please be aware that it is still a release candidate and not yet fully stable.
 
Upgrade from v1 to v2
 
 
⚠ Before upgrading from V1, make sure that you have a backup of your currently working configuration files and database!
 
 
To start the upgrade process, start the wg-portal binary with the -migrateFrom parameter. The configuration (config.yml) for WireGuard Portal must be updated and valid before starting the upgrade.
 
To upgrade from a previous SQLite database, start wg-portal like:
 
./wg-portal-amd64 -migrateFrom=old_wg_portal.db
+ Upgrade - WireGuard Portal      
 
  
  
 
  
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
Upgrade
 
For production deployments of WireGuard Portal, we strongly recommend using version 1. If you want to use version 2, please be aware that it is still a release candidate and not yet fully stable.
 
Upgrade from v1 to v2
 
 
⚠ Before upgrading from V1, make sure that you have a backup of your currently working configuration files and database!
 
 
To start the upgrade process, start the wg-portal binary with the -migrateFrom parameter. The configuration (config.yaml) for WireGuard Portal must be updated and valid before starting the upgrade.
 
To upgrade from a previous SQLite database, start wg-portal like:
 
./wg-portal-amd64 -migrateFrom=old_wg_portal.db
 
 
You can also specify the database type using the parameter -migrateFromType, supported types: mysql, mssql, postgres or sqlite. For example:
 
./wg-portal-amd64 -migrateFromType=mysql -migrateFrom='user:pass@tcp(1.2.3.4:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local'
-
 
The upgrade will transform the old, existing database and store the values in the new database specified in the config.yml configuration file. Ensure that the new database does not contain any data!
 
If you are using Docker, you can adapt the docker-compose.yml file to start the upgrade process:
 
services:
+
 
The upgrade will transform the old, existing database and store the values in the new database specified in the config.yaml configuration file. Ensure that the new database does not contain any data!
 
If you are using Docker, you can adapt the docker-compose.yml file to start the upgrade process:
 
services:
   wg-portal:
     image: wgportal/wg-portal:latest
     # ... other settings
diff --git a/master/index.html b/master/index.html
index 0a11bd4..5a8e1a9 100644
--- a/master/index.html
+++ b/master/index.html
@@ -292,4 +292,4 @@
   background: var(--md-accent-fg-color--transparent);
 }
 
-  
 
 
 
 
A beautiful and simple UI to manage your WireGuard peers and interfaces
 
WireGuard Portal is an open source web-based user interface that makes it easy to setup and manage WireGuard VPN connections. It's built on top of WireGuard's official wgctrl library.
 
  Get started   
 
 
 
 
 
  
 
 
 
  
 
 
 
More information about WireGuard
 
 WireGuard® is an extremely simple yet fast and modern VPN that utilizes state-of-the-art cryptography. 
 
 WireGuard uses state-of-the-art cryptography and still manages to be as easy to configure and deploy as SSH. A combination of extremely high-speed cryptographic primitives and the fact that WireGuard lives inside the Linux kernel means that secure networking can be very high-speed. It is suitable for both small embedded devices like smartphones and fully loaded backbone routers. 
 
 
 
  
 
 
 
 
Explore official documentation
  
  
  
 
Official Website
 
 If you'd like a general conceptual overview of what WireGuard is about, read onward here. 
 
 
    
  
 
Protocol & Cryptography
 
 WireGuard uses state-of-the-art cryptography, like the Noise protocol framework, Curve25519, ChaCha20, Poly1305, BLAKE2, SipHash24, HKDF, and secure trusted constructions. 
 
 
    
  
 
Client Installation
 
 You may progress to installation and reading the quickstart instructions on how to use it. 
 
 
  
 
 
 
 
 
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
 
  
 
   
 
 
 
    
\ No newline at end of file
+  
 
 
 
 
A beautiful and simple UI to manage your WireGuard peers and interfaces
 
WireGuard Portal is an open source web-based user interface that makes it easy to setup and manage WireGuard VPN connections. It's built on top of WireGuard's official wgctrl library.
 
  Get started   
 
 
 
 
 
  
 
 
 
  
 
 
 
More information about WireGuard
 
 WireGuard® is an extremely simple yet fast and modern VPN that utilizes state-of-the-art cryptography. 
 
 WireGuard uses state-of-the-art cryptography and still manages to be as easy to configure and deploy as SSH. A combination of extremely high-speed cryptographic primitives and the fact that WireGuard lives inside the Linux kernel means that secure networking can be very high-speed. It is suitable for both small embedded devices like smartphones and fully loaded backbone routers. 
 
 
 
  
 
 
 
 
Explore official documentation
  
  
  
 
Official Website
 
 If you'd like a general conceptual overview of what WireGuard is about, read onward here. 
 
 
    
  
 
Protocol & Cryptography
 
 WireGuard uses state-of-the-art cryptography, like the Noise protocol framework, Curve25519, ChaCha20, Poly1305, BLAKE2, SipHash24, HKDF, and secure trusted constructions. 
 
 
    
  
 
Client Installation
 
 You may progress to installation and reading the quickstart instructions on how to use it. 
 
 
  
 
 
 
 
 
 
 
 
 
  
 
 
 
 
 
  
 
 
 
 
 
 
  
 
   
 
 
 
    
\ No newline at end of file
diff --git a/master/search/search_index.json b/master/search/search_index.json
index 2f63c1c..6e41caf 100644
--- a/master/search/search_index.json
+++ b/master/search/search_index.json
@@ -1 +1 @@
-{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"documentation/overview/","title":"Overview","text":"
WireGuard Portal is a simple, web-based configuration portal for WireGuard server management. The portal uses the WireGuard wgctrl library to manage existing VPN interfaces. This allows for the seamless activation or deactivation of new users without disturbing existing VPN connections.
 
The configuration portal supports using a database (SQLite, MySQL, MsSQL or Postgres), OAuth or LDAP (Active Directory or OpenLDAP) as a user source for authentication and profile data.
"},{"location":"documentation/overview/#features","title":"Features","text":"
     
  • Self-hosted - the whole application is a single binary
    •  
  • Responsive multi-language web UI written in Vue.js
    •  
  • Automatically selects IP from the network pool assigned to the client
    •  
  • QR-Code for convenient mobile client configuration
    •  
  • Sends email to the client with QR-code and client config
    •  
  • Enable / Disable clients seamlessly
    •  
  • Generation of wg-quick configuration file (wgX.conf) if required
    •  
  • User authentication (database, OAuth, or LDAP)
    •  
  • IPv6 ready
    •  
  • Docker ready
    •  
  • Can be used with existing WireGuard setups
    •  
  • Support for multiple WireGuard interfaces
    •  
  • Peer Expiry Feature
    •  
  • Handles route and DNS settings like wg-quick does
    •  
  • Exposes Prometheus metrics for monitoring and alerting
    •  
  • REST API for management and client deployment
    •  
  • Webhook for custom actions on peer, interface or user updates
    •  
"},{"location":"documentation/configuration/examples/","title":"Examples","text":"
Below are some sample YAML configurations demonstrating how to override some default values.
"},{"location":"documentation/configuration/examples/#basic","title":"Basic","text":"
core:\n  admin_user: test@example.com\n  admin_password: password\n  admin_api_token: super-s3cr3t-api-token-or-a-UUID\n  import_existing: false\n  create_default_peer: true\n  self_provisioning_allowed: true\n\nweb:\n  site_title: My WireGuard Server\n  site_company_name: My Company\n  listening_address: :8080\n  external_url: https://my.externa-domain.com\n  csrf_secret: super-s3cr3t-csrf\n  session_secret: super-s3cr3t-session\n  request_logging: true\n\nadvanced:\n  log_level: trace\n  log_pretty: true\n  log_json: false\n  config_storage_path: /etc/wireguard\n  expiry_check_interval: 5m\n\ndatabase:\n  debug: true\n  type: sqlite\n  dsn: data/sqlite.db\n  encryption_passphrase: change-this-s3cr3t-encryption-passphrase\n
"},{"location":"documentation/configuration/examples/#ldap-authentication-and-synchronization","title":"LDAP Authentication and Synchronization","text":"
# ... (basic configuration)\n\nauth:\n  ldap:\n    # a sample LDAP provider with user sync enabled\n    - id: ldap\n      provider_name: Active Directory\n      url: ldap://srv-ad1.company.local:389\n      bind_user: ldap_wireguard@company.local\n      bind_pass: super-s3cr3t-ldap\n      base_dn: DC=COMPANY,DC=LOCAL\n      login_filter: (&(objectClass=organizationalPerson)(mail={{login_identifier}})(!userAccountControl:1.2.840.113556.1.4.803:=2))\n      sync_interval: 15m\n      sync_filter: (&(objectClass=organizationalPerson)(!userAccountControl:1.2.840.113556.1.4.803:=2)(mail=*))\n      disable_missing: true\n      field_map:\n        user_identifier: sAMAccountName\n        email: mail\n        firstname: givenName\n        lastname: sn\n        phone: telephoneNumber\n        department: department\n        memberof: memberOf\n      admin_group: CN=WireGuardAdmins,OU=Some-OU,DC=COMPANY,DC=LOCAL\n      registration_enabled: true\n      log_user_info: true\n
"},{"location":"documentation/configuration/examples/#openid-connect-oidc-authentication","title":"OpenID Connect (OIDC) Authentication","text":"
# ... (basic configuration)\n\nauth:\n  oidc:\n    # a sample Entra ID provider with environment variable substitution\n    - id: azure\n      provider_name: azure\n      display_name: Login with</br>Entra ID\n      registration_enabled: true\n      base_url: \"https://login.microsoftonline.com/${AZURE_TENANT_ID}/v2.0\"\n      client_id: \"${AZURE_CLIENT_ID}\"\n      client_secret: \"${AZURE_CLIENT_SECRET}\"\n      extra_scopes:\n        - profile\n        - email\n\n    # a sample provider where users with the attribute `wg_admin` set to `true` are considered as admins\n    - id: oidc-with-admin-attribute\n      provider_name: google\n      display_name: Login with</br>Google\n      base_url: https://accounts.google.com\n      client_id: the-client-id-1234.apps.googleusercontent.com\n      client_secret: A_CLIENT_SECRET\n      extra_scopes:\n        - https://www.googleapis.com/auth/userinfo.email\n        - https://www.googleapis.com/auth/userinfo.profile\n      field_map:\n        user_identifier: sub\n        email: email\n        firstname: given_name\n        lastname: family_name\n        phone: phone_number\n        department: department\n        is_admin: wg_admin\n      admin_mapping:\n        admin_value_regex: ^true$\n      registration_enabled: true\n      log_user_info: true\n\n    # a sample provider where users in the group `the-admin-group` are considered as admins\n    - id: oidc-with-admin-group\n      provider_name: google2\n      display_name: Login with</br>Google2\n      base_url: https://accounts.google.com\n      client_id: another-client-id-1234.apps.googleusercontent.com\n      client_secret: A_CLIENT_SECRET\n      extra_scopes:\n        - https://www.googleapis.com/auth/userinfo.email\n        - https://www.googleapis.com/auth/userinfo.profile\n      field_map:\n        user_identifier: sub\n        email: email\n        firstname: given_name\n        lastname: family_name\n        phone: phone_number\n        department: department\n        user_groups: groups\n      admin_mapping:\n        admin_group_regex: ^the-admin-group$\n      registration_enabled: true\n      log_user_info: true\n
"},{"location":"documentation/configuration/examples/#plain-oauth2-authentication","title":"Plain OAuth2 Authentication","text":"
# ... (basic configuration)\n\nauth:\n  oauth:\n    # a sample provider where users with the attribute `this-attribute-must-be-true` set to `true` or `True`\n    # are considered as admins\n    - id: google_plain_oauth-with-admin-attribute\n      provider_name: google3\n      display_name: Login with</br>Google3\n      client_id: another-client-id-1234.apps.googleusercontent.com\n      client_secret: A_CLIENT_SECRET\n      auth_url: https://accounts.google.com/o/oauth2/v2/auth\n      token_url: https://oauth2.googleapis.com/token\n      user_info_url: https://openidconnect.googleapis.com/v1/userinfo\n      scopes:\n        - openid\n        - email\n        - profile\n      field_map:\n        user_identifier: sub\n        email: email\n        firstname: name\n        is_admin: this-attribute-must-be-true\n      admin_mapping:\n        admin_value_regex: ^(True|true)$\n      registration_enabled: true\n\n    # a sample provider where either users with the attribute `this-attribute-must-be-true` set to `true` or \n    # users in the group `admin-group-name` are considered as admins\n    - id: google_plain_oauth_with_groups\n      provider_name: google4\n      display_name: Login with</br>Google4\n      client_id: another-client-id-1234.apps.googleusercontent.com\n      client_secret: A_CLIENT_SECRET\n      auth_url: https://accounts.google.com/o/oauth2/v2/auth\n      token_url: https://oauth2.googleapis.com/token\n      user_info_url: https://openidconnect.googleapis.com/v1/userinfo\n      scopes:\n        - openid\n        - email\n        - profile\n        - i-want-some-groups\n      field_map:\n        email: email\n        firstname: name\n        user_identifier: sub\n        is_admin: this-attribute-must-be-true\n        user_groups: groups\n      admin_mapping:\n        admin_value_regex: ^true$\n        admin_group_regex: ^admin-group-name$\n      registration_enabled: true\n      log_user_info: true\n
"},{"location":"documentation/configuration/overview/","title":"Overview","text":"
This page provides an overview of all available configuration options for WireGuard Portal.
 
You can supply these configurations in a YAML file (e.g. config.yaml) when starting the Portal. The path of the configuration file defaults to config/config.yml in the working directory of the executable. It is possible to override configuration filepath using the environment variable WG_PORTAL_CONFIG. For example: WG_PORTAL_CONFIG=/etc/wg-portal/config.yaml ./wg-portal. Also, environment variable substitution in config file is supported. Refer to syntax.
 
Configuration examples are available on the Examples page.
 Default configuration 
core:\n  admin_user: admin@wgportal.local\n  admin_password: wgportal\n  editable_keys: true\n  create_default_peer: false\n  create_default_peer_on_creation: false\n  re_enable_peer_after_user_enable: true\n  delete_peer_after_user_deleted: false\n  self_provisioning_allowed: false\n  import_existing: true\n  restore_state: true\n\nadvanced:\n  log_level: info\n  log_pretty: false\n  log_json: false\n  start_listen_port: 51820\n  start_cidr_v4: 10.11.12.0/24\n  start_cidr_v6: fdfd:d3ad:c0de:1234::0/64\n  use_ip_v6: true\n  config_storage_path: \"\"\n  expiry_check_interval: 15m\n  rule_prio_offset: 20000\n  api_admin_only: true\n\ndatabase:\n  debug: false\n  slow_query_threshold: 0\n  type: sqlite\n  dsn: data/sqlite.db\n\nstatistics:\n  use_ping_checks: true\n  ping_check_workers: 10\n  ping_unprivileged: false\n  ping_check_interval: 1m\n  data_collection_interval: 1m\n  collect_interface_data: true\n  collect_peer_data: true\n  collect_audit_data: true\n  listening_address: :8787\n\nmail:\n  host: 127.0.0.1\n  port: 25\n  encryption: none\n  cert_validation: true\n  username: \"\"\n  password: \"\"\n  auth_type: plain\n  from: Wireguard Portal <noreply@wireguard.local>\n  link_only: false\n\nauth:\n  oidc: []\n  oauth: []\n  ldap: []\n\nweb:\n  listening_address: :8888\n  external_url: http://localhost:8888\n  site_company_name: WireGuard Portal\n  site_title: WireGuard Portal\n  session_identifier: wgPortalSession\n  session_secret: very_secret\n  csrf_secret: extremely_secret\n  request_logging: false\n  cert_file: \"\"\n  key_File: \"\"\n\nwebhook:\n  url: \"\"\n  authentication: \"\"\n  timeout: 10s\n
 
Below you will find sections like core, advanced, database, statistics, mail, auth, web and webhook. Each section describes the individual configuration keys, their default values, and a brief explanation of their purpose.
"},{"location":"documentation/configuration/overview/#core","title":"Core","text":"
These are the primary configuration options that control fundamental WireGuard Portal behavior. More advanced options are found in the subsequent Advanced section.
"},{"location":"documentation/configuration/overview/#admin_user","title":"admin_user","text":"
     
  • Default: admin@wgportal.local
    •  
  • Description: The administrator user. This user will be created as a default admin if it does not yet exist.
    •  
"},{"location":"documentation/configuration/overview/#admin_password","title":"admin_password","text":"
     
  • Default: wgportal
    •  
  • Description: The administrator password. The default password of wgportal should be changed immediately.
    •  
"},{"location":"documentation/configuration/overview/#admin_api_token","title":"admin_api_token","text":"
     
  • Default: (empty)
    •  
  • Description: An API token for the admin user. If a token is provided, the REST API can be accessed using this token. If empty, the API is initially disabled for the admin user.
    •  
"},{"location":"documentation/configuration/overview/#editable_keys","title":"editable_keys","text":"
     
  • Default: true
    •  
  • Description: Allow editing of WireGuard key-pairs directly in the UI.
    •  
"},{"location":"documentation/configuration/overview/#create_default_peer","title":"create_default_peer","text":"
     
  • Default: false
    •  
  • Description: If a user logs in for the first time with no existing peers, automatically create a new WireGuard peer for all server interfaces.
    •  
"},{"location":"documentation/configuration/overview/#create_default_peer_on_creation","title":"create_default_peer_on_creation","text":"
     
  • Default: false
    •  
  • Description: If an LDAP user is created (e.g., through LDAP sync) and has no peers, automatically create a new WireGuard peer for all server interfaces.
    •  
"},{"location":"documentation/configuration/overview/#re_enable_peer_after_user_enable","title":"re_enable_peer_after_user_enable","text":"
     
  • Default: true
    •  
  • Description: Re-enable all peers that were previously disabled if the associated user is re-enabled.
    •  
"},{"location":"documentation/configuration/overview/#delete_peer_after_user_deleted","title":"delete_peer_after_user_deleted","text":"
     
  • Default: false
    •  
  • Description: If a user is deleted, remove all linked peers. Otherwise, peers remain but are disabled.
    •  
"},{"location":"documentation/configuration/overview/#self_provisioning_allowed","title":"self_provisioning_allowed","text":"
     
  • Default: false
    •  
  • Description: Allow registered (non-admin) users to self-provision peers from their profile page.
    •  
"},{"location":"documentation/configuration/overview/#import_existing","title":"import_existing","text":"
     
  • Default: true
    •  
  • Description: On startup, import existing WireGuard interfaces and peers into WireGuard Portal.
    •  
"},{"location":"documentation/configuration/overview/#restore_state","title":"restore_state","text":"
     
  • Default: true
    •  
  • Description: Restore the WireGuard interface states (up/down) that existed before WireGuard Portal started.
    •  
"},{"location":"documentation/configuration/overview/#advanced","title":"Advanced","text":"
Additional or more specialized configuration options for logging and interface creation details.
"},{"location":"documentation/configuration/overview/#log_level","title":"log_level","text":"
     
  • Default: info
    •  
  • Description: The log level used by the application. Valid options are: trace, debug, info, warn, error.
    •  
"},{"location":"documentation/configuration/overview/#log_pretty","title":"log_pretty","text":"
     
  • Default: false
    •  
  • Description: If true, log messages are colorized and formatted for readability (pretty-print).
    •  
"},{"location":"documentation/configuration/overview/#log_json","title":"log_json","text":"
     
  • Default: false
    •  
  • Description: If true, log messages are structured in JSON format.
    •  
"},{"location":"documentation/configuration/overview/#start_listen_port","title":"start_listen_port","text":"
     
  • Default: 51820
    •  
  • Description: The first port to use when automatically creating new WireGuard interfaces.
    •  
"},{"location":"documentation/configuration/overview/#start_cidr_v4","title":"start_cidr_v4","text":"
     
  • Default: 10.11.12.0/24
    •  
  • Description: The initial IPv4 subnet to use when automatically creating new WireGuard interfaces.
    •  
"},{"location":"documentation/configuration/overview/#start_cidr_v6","title":"start_cidr_v6","text":"
     
  • Default: fdfd:d3ad:c0de:1234::0/64
    •  
  • Description: The initial IPv6 subnet to use when automatically creating new WireGuard interfaces.
    •  
"},{"location":"documentation/configuration/overview/#use_ip_v6","title":"use_ip_v6","text":"
     
  • Default: true
    •  
  • Description: Enable or disable IPv6 support.
    •  
"},{"location":"documentation/configuration/overview/#config_storage_path","title":"config_storage_path","text":"
     
  • Default: (empty)
    •  
  • Description: Path to a directory where wg-quick style configuration files will be stored (if you need local filesystem configs).
    •  
"},{"location":"documentation/configuration/overview/#expiry_check_interval","title":"expiry_check_interval","text":"
     
  • Default: 15m
    •  
  • Description: Interval after which existing peers are checked if they are expired. Format uses s, m, h, d for seconds, minutes, hours, days, see time.ParseDuration.
    •  
"},{"location":"documentation/configuration/overview/#rule_prio_offset","title":"rule_prio_offset","text":"
     
  • Default: 20000
    •  
  • Description: Offset for IP route rule priorities when configuring routing.
    •  
"},{"location":"documentation/configuration/overview/#route_table_offset","title":"route_table_offset","text":"
     
  • Default: 20000
    •  
  • Description: Offset for IP route table IDs when configuring routing.
    •  
"},{"location":"documentation/configuration/overview/#api_admin_only","title":"api_admin_only","text":"
     
  • Default: true
    •  
  • Description: If true, the public REST API is accessible only to admin users. The API docs live at /api/v1/doc.html.
    •  
"},{"location":"documentation/configuration/overview/#database","title":"Database","text":"
Configuration for the underlying database used by WireGuard Portal.  Supported databases include SQLite, MySQL, Microsoft SQL Server, and Postgres.
 
If sensitive values (like private keys) should be stored in an encrypted format, set the encryption_passphrase option.
"},{"location":"documentation/configuration/overview/#debug","title":"debug","text":"
     
  • Default: false
    •  
  • Description: If true, logs all database statements (verbose).
    •  
"},{"location":"documentation/configuration/overview/#slow_query_threshold","title":"slow_query_threshold","text":"
     
  • Default: 0
    •  
  • Description: A time threshold (e.g., 100ms) above which queries are considered slow and logged as warnings. If empty or zero, slow query logging is disabled. Format uses s, ms for seconds, milliseconds, see time.ParseDuration.
    •  
"},{"location":"documentation/configuration/overview/#type","title":"type","text":"
     
  • Default: sqlite
    •  
  • Description: The database type. Valid options: sqlite, mssql, mysql, postgres.
    •  
"},{"location":"documentation/configuration/overview/#dsn","title":"dsn","text":"
     
  • Default: data/sqlite.db
    •  
  • Description: The Data Source Name (DSN) for connecting to the database.   For example:   
    user:pass@tcp(1.2.3.4:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local\n
    •  
"},{"location":"documentation/configuration/overview/#encryption_passphrase","title":"encryption_passphrase","text":"
     
  • Default: (empty)
    •  
  • Description: Passphrase for encrypting sensitive values such as private keys in the database. Encryption is only applied if this passphrase is set.   Important: Once you enable encryption by setting this passphrase, you cannot disable it or change it afterward.    New or updated records will be encrypted; existing data remains in plaintext until it\u2019s next modified.
    •  
"},{"location":"documentation/configuration/overview/#statistics","title":"Statistics","text":"
Controls how WireGuard Portal collects and reports usage statistics, including ping checks and Prometheus metrics.
"},{"location":"documentation/configuration/overview/#use_ping_checks","title":"use_ping_checks","text":"
     
  • Default: true
    •  
  • Description: Enable periodic ping checks to verify that peers remain responsive.
    •  
"},{"location":"documentation/configuration/overview/#ping_check_workers","title":"ping_check_workers","text":"
     
  • Default: 10
    •  
  • Description: Number of parallel worker processes for ping checks.
    •  
"},{"location":"documentation/configuration/overview/#ping_unprivileged","title":"ping_unprivileged","text":"
     
  • Default: false
    •  
  • Description: If false, ping checks run without root privileges. This is currently considered BETA.
    •  
"},{"location":"documentation/configuration/overview/#ping_check_interval","title":"ping_check_interval","text":"
     
  • Default: 1m
    •  
  • Description: Interval between consecutive ping checks for all peers. Format uses s, m, h, d for seconds, minutes, hours, days, see time.ParseDuration.
    •  
"},{"location":"documentation/configuration/overview/#data_collection_interval","title":"data_collection_interval","text":"
     
  • Default: 1m
    •  
  • Description: Interval between data collection cycles (bytes sent/received, handshake times, etc.). Format uses s, m, h, d for seconds, minutes, hours, days, see time.ParseDuration.
    •  
"},{"location":"documentation/configuration/overview/#collect_interface_data","title":"collect_interface_data","text":"
     
  • Default: true
    •  
  • Description: If true, collects interface-level data (bytes in/out) for monitoring and statistics.
    •  
"},{"location":"documentation/configuration/overview/#collect_peer_data","title":"collect_peer_data","text":"
     
  • Default: true
    •  
  • Description: If true, collects peer-level data (bytes, last handshake, endpoint, etc.).
    •  
"},{"location":"documentation/configuration/overview/#collect_audit_data","title":"collect_audit_data","text":"
     
  • Default: true
    •  
  • Description: If true, logs certain portal events (such as user logins) to the database.
    •  
"},{"location":"documentation/configuration/overview/#listening_address","title":"listening_address","text":"
     
  • Default: :8787
    •  
  • Description: Address and port for the integrated Prometheus metric server (e.g., :8787).
    •  
"},{"location":"documentation/configuration/overview/#mail","title":"Mail","text":"
Options for configuring email notifications or sending peer configurations via email.
"},{"location":"documentation/configuration/overview/#host","title":"host","text":"
     
  • Default: 127.0.0.1
    •  
  • Description: Hostname or IP of the SMTP server.
    •  
"},{"location":"documentation/configuration/overview/#port","title":"port","text":"
     
  • Default: 25
    •  
  • Description: Port number for the SMTP server.
    •  
"},{"location":"documentation/configuration/overview/#encryption","title":"encryption","text":"
     
  • Default: none
    •  
  • Description: SMTP encryption type. Valid values: none, tls, starttls.
    •  
"},{"location":"documentation/configuration/overview/#cert_validation","title":"cert_validation","text":"
     
  • Default: true
    •  
  • Description: If true, validate the SMTP server certificate (relevant if encryption = tls).
    •  
"},{"location":"documentation/configuration/overview/#username","title":"username","text":"
     
  • Default: (empty)
    •  
  • Description: Optional SMTP username for authentication.
    •  
"},{"location":"documentation/configuration/overview/#password","title":"password","text":"
     
  • Default: (empty)
    •  
  • Description: Optional SMTP password for authentication.
    •  
"},{"location":"documentation/configuration/overview/#auth_type","title":"auth_type","text":"
     
  • Default: plain
    •  
  • Description: SMTP authentication type. Valid values: plain, login, crammd5.
    •  
"},{"location":"documentation/configuration/overview/#from","title":"from","text":"
     
  • Default: Wireguard Portal <noreply@wireguard.local>
    •  
  • Description: The default \"From\" address when sending emails.
    •  
"},{"location":"documentation/configuration/overview/#link_only","title":"link_only","text":"
     
  • Default: false
    •  
  • Description: If true, emails only contain a link to WireGuard Portal, rather than attaching the full configuration.
    •  
"},{"location":"documentation/configuration/overview/#auth","title":"Auth","text":"
WireGuard Portal supports multiple authentication strategies, including OpenID Connect (oidc), OAuth (oauth), and LDAP (ldap). Each can have multiple providers configured. Below are the relevant keys.
"},{"location":"documentation/configuration/overview/#oidc","title":"OIDC","text":"
The oidc array contains a list of OpenID Connect providers.  Below are the properties for each OIDC provider entry inside auth.oidc:
"},{"location":"documentation/configuration/overview/#provider_name","title":"provider_name","text":"
     
  • Default: (empty)
    •  
  • Description: A unique name for this provider. Must not conflict with other providers.
    •  
"},{"location":"documentation/configuration/overview/#display_name","title":"display_name","text":"
     
  • Default: (empty)
    •  
  • Description: A user-friendly name shown on the login page (e.g., \"Login with Google\").
    •  
"},{"location":"documentation/configuration/overview/#base_url","title":"base_url","text":"
     
  • Default: (empty)
    •  
  • Description: The OIDC provider\u2019s base URL (e.g., https://accounts.google.com).
    •  
"},{"location":"documentation/configuration/overview/#client_id","title":"client_id","text":"
     
  • Default: (empty)
    •  
  • Description: The OAuth client ID from the OIDC provider.
    •  
"},{"location":"documentation/configuration/overview/#client_secret","title":"client_secret","text":"
     
  • Default: (empty)
    •  
  • Description: The OAuth client secret from the OIDC provider.
    •  
"},{"location":"documentation/configuration/overview/#extra_scopes","title":"extra_scopes","text":"
     
  • Default: (empty)
    •  
  • Description: A list of additional OIDC scopes (e.g., profile, email).
    •  
"},{"location":"documentation/configuration/overview/#field_map","title":"field_map","text":"
     
  • Default: (empty)
    •  
  • Description: Maps OIDC claims to WireGuard Portal user fields. 
    •  
  •  
    Available fields: user_identifier, email, firstname, lastname, phone, department, is_admin, user_groups.
     Field Typical OIDC Claim Explanation user_identifier sub or preferred_username A unique identifier for the user. Often the OIDC sub claim is used because it\u2019s guaranteed to be unique for the user within the IdP. Some providers also support preferred_username if it\u2019s unique. email email The user\u2019s email address as provided by the IdP. Not always verified, depending on IdP settings. firstname given_name The user\u2019s first name, typically provided by the IdP in the given_name claim. lastname family_name The user\u2019s last (family) name, typically provided by the IdP in the family_name claim. phone phone_number The user\u2019s phone number. This may require additional scopes/permissions from the IdP to access. department Custom claim (e.g., department) If the IdP can provide organizational data, it may store it in a custom claim. Adjust accordingly (e.g., department, org, or another attribute). is_admin Custom claim or derived role If the IdP returns a role or admin flag, you can map that to is_admin. Often this is managed through custom claims or group membership. user_groups groups or another custom claim A list of group memberships for the user. Some IdPs provide groups out of the box; others require custom claims or directory lookups. 
    •  
"},{"location":"documentation/configuration/overview/#admin_mapping","title":"admin_mapping","text":"
     
  • Default: (empty)
    •  
  • Description: WgPortal can grant a user admin rights by matching the value of the is_admin claim against a regular expression. Alternatively, a regular expression can be used to check if a user is member of a specific group listed in the user_group claim. The regular expressions are defined in admin_value_regex and admin_group_regex.
       
    • admin_value_regex: A regular expression to match the is_admin claim. By default, this expression matches the string \"true\" (^true$).
      •  
    • admin_group_regex: A regular expression to match the user_groups claim. Each entry in the user_groups claim is checked against this regex.
      •  
     
    •  
"},{"location":"documentation/configuration/overview/#registration_enabled","title":"registration_enabled","text":"
     
  • Default: (empty)
    •  
  • Description: If true, a new user will be created in WireGuard Portal if not already present.
    •  
"},{"location":"documentation/configuration/overview/#log_user_info","title":"log_user_info","text":"
     
  • Default: (empty)
    •  
  • Description: If true, OIDC user data is logged at the trace level upon login (for debugging).
    •  
"},{"location":"documentation/configuration/overview/#oauth","title":"OAuth","text":"
The oauth array contains a list of plain OAuth2 providers. Below are the properties for each OAuth provider entry inside auth.oauth:
"},{"location":"documentation/configuration/overview/#provider_name_1","title":"provider_name","text":"
     
  • Default: (empty)
    •  
  • Description: A unique name for this provider. Must not conflict with other providers.
    •  
"},{"location":"documentation/configuration/overview/#display_name_1","title":"display_name","text":"
     
  • Default: (empty)
    •  
  • Description: A user-friendly name shown on the login page.
    •  
"},{"location":"documentation/configuration/overview/#client_id_1","title":"client_id","text":"
     
  • Default: (empty)
    •  
  • Description: The OAuth client ID for the provider.
    •  
"},{"location":"documentation/configuration/overview/#client_secret_1","title":"client_secret","text":"
     
  • Default: (empty)
    •  
  • Description: The OAuth client secret for the provider.
    •  
"},{"location":"documentation/configuration/overview/#auth_url","title":"auth_url","text":"
     
  • Default: (empty)
    •  
  • Description: URL of the authentication endpoint.
    •  
"},{"location":"documentation/configuration/overview/#token_url","title":"token_url","text":"
     
  • Default: (empty)
    •  
  • Description: URL of the token endpoint.
    •  
"},{"location":"documentation/configuration/overview/#user_info_url","title":"user_info_url","text":"
     
  • Default: (empty)
    •  
  • Description: URL of the user information endpoint.
    •  
"},{"location":"documentation/configuration/overview/#scopes","title":"scopes","text":"
     
  • Default: (empty)
    •  
  • Description: A list of OAuth scopes.
    •  
"},{"location":"documentation/configuration/overview/#field_map_1","title":"field_map","text":"
     
  • Default: (empty)
    •  
  • Description: Maps OAuth attributes to WireGuard Portal fields.
    •  
  •  
    Available fields: user_identifier, email, firstname, lastname, phone, department, is_admin, user_groups.
     Field Typical Claim Explanation user_identifier sub or preferred_username A unique identifier for the user. Often the OIDC sub claim is used because it\u2019s guaranteed to be unique for the user within the IdP. Some providers also support preferred_username if it\u2019s unique. email email The user\u2019s email address as provided by the IdP. Not always verified, depending on IdP settings. firstname given_name The user\u2019s first name, typically provided by the IdP in the given_name claim. lastname family_name The user\u2019s last (family) name, typically provided by the IdP in the family_name claim. phone phone_number The user\u2019s phone number. This may require additional scopes/permissions from the IdP to access. department Custom claim (e.g., department) If the IdP can provide organizational data, it may store it in a custom claim. Adjust accordingly (e.g., department, org, or another attribute). is_admin Custom claim or derived role If the IdP returns a role or admin flag, you can map that to is_admin. Often this is managed through custom claims or group membership. user_groups groups or another custom claim A list of group memberships for the user. Some IdPs provide groups out of the box; others require custom claims or directory lookups. 
    •  
"},{"location":"documentation/configuration/overview/#admin_mapping_1","title":"admin_mapping","text":"
     
  • Default: (empty)
    •  
  • Description: WgPortal can grant a user admin rights by matching the value of the is_admin claim against a regular expression. Alternatively, a regular expression can be used to check if a user is member of a specific group listed in the user_group claim. The regular expressions are defined in admin_value_regex and admin_group_regex.
    •  
  • admin_value_regex: A regular expression to match the is_admin claim. By default, this expression matches the string \"true\" (^true$).
    •  
  • admin_group_regex: A regular expression to match the user_groups claim. Each entry in the user_groups claim is checked against this regex.
    •  
"},{"location":"documentation/configuration/overview/#registration_enabled_1","title":"registration_enabled","text":"
     
  • Default: (empty)
    •  
  • Description: If true, new users are created automatically on successful login.
    •  
"},{"location":"documentation/configuration/overview/#log_user_info_1","title":"log_user_info","text":"
     
  • Default: (empty)
    •  
  • Description: If true, logs user info at the trace level upon login.
    •  
"},{"location":"documentation/configuration/overview/#ldap","title":"LDAP","text":"
The ldap array contains a list of LDAP authentication providers. Below are the properties for each LDAP provider entry inside auth.ldap:
"},{"location":"documentation/configuration/overview/#provider_name_2","title":"provider_name","text":"
     
  • Default: (empty)
    •  
  • Description: A unique name for this provider. Must not conflict with other providers.
    •  
"},{"location":"documentation/configuration/overview/#url","title":"url","text":"
     
  • Default: (empty)
    •  
  • Description: The LDAP server URL (e.g., ldap://srv-ad01.company.local:389).
    •  
"},{"location":"documentation/configuration/overview/#start_tls","title":"start_tls","text":"
     
  • Default: (empty)
    •  
  • Description: If true, use STARTTLS to secure the LDAP connection.
    •  
"},{"location":"documentation/configuration/overview/#cert_validation_1","title":"cert_validation","text":"
     
  • Default: (empty)
    •  
  • Description: If true, validate the LDAP server\u2019s TLS certificate.
    •  
"},{"location":"documentation/configuration/overview/#tls_certificate_path","title":"tls_certificate_path","text":"
     
  • Default: (empty)
    •  
  • Description: Path to a TLS certificate if needed for LDAP connections.
    •  
"},{"location":"documentation/configuration/overview/#tls_key_path","title":"tls_key_path","text":"
     
  • Default: (empty)
    •  
  • Description: Path to the corresponding TLS certificate key.
    •  
"},{"location":"documentation/configuration/overview/#base_dn","title":"base_dn","text":"
     
  • Default: (empty)
    •  
  • Description: The base DN for user searches (e.g., DC=COMPANY,DC=LOCAL).
    •  
"},{"location":"documentation/configuration/overview/#bind_user","title":"bind_user","text":"
     
  • Default: (empty)
    •  
  • Description: The bind user for LDAP (e.g., company\\\\ldap_wireguard or ldap_wireguard@company.local).
    •  
"},{"location":"documentation/configuration/overview/#bind_pass","title":"bind_pass","text":"
     
  • Default: (empty)
    •  
  • Description: The bind password for LDAP authentication.
    •  
"},{"location":"documentation/configuration/overview/#field_map_2","title":"field_map","text":"
     
  • Default: (empty)
    •  
  •  
    Description: Maps LDAP attributes to WireGuard Portal fields.
     
       
    • Available fields: user_identifier, email, firstname, lastname, phone, department, memberof.
      •  
     WireGuard Portal Field Typical LDAP Attribute Short Description user_identifier sAMAccountName / uid Uniquely identifies the user within the LDAP directory. email mail / userPrincipalName Stores the user's primary email address. firstname givenName Contains the user's first (given) name. lastname sn Contains the user's last (surname) name. phone telephoneNumber / mobile Holds the user's phone or mobile number. department departmentNumber / ou Specifies the department or organizational unit of the user. memberof memberOf Lists the groups and roles to which the user belongs. 
    •  
"},{"location":"documentation/configuration/overview/#login_filter","title":"login_filter","text":"
     
  • Default: (empty)
    •  
  • Description: An LDAP filter to restrict which users can log in. Use {{login_identifier}} to insert the username.   For example:   
    (&(objectClass=organizationalPerson)(mail={{login_identifier}})(!userAccountControl:1.2.840.113556.1.4.803:=2))\n
    •  
"},{"location":"documentation/configuration/overview/#admin_group","title":"admin_group","text":"
     
  • Default: (empty)
    •  
  • Description: A specific LDAP group whose members are considered administrators in WireGuard Portal.   For example:   
    CN=WireGuardAdmins,OU=Some-OU,DC=YOURDOMAIN,DC=LOCAL\n
    •  
"},{"location":"documentation/configuration/overview/#sync_interval","title":"sync_interval","text":"
     
  • Default: (empty)
    •  
  • Description: How frequently (in duration, e.g. 30m) to synchronize users from LDAP. Empty or 0 disables sync. Format uses s, m, h, d for seconds, minutes, hours, days, see time.ParseDuration.   Only users that match the sync_filter are synchronized, if disable_missing is true, users not found in LDAP are disabled.
    •  
"},{"location":"documentation/configuration/overview/#sync_filter","title":"sync_filter","text":"
     
  • Default: (empty)
    •  
  • Description: An LDAP filter to select which users get synchronized into WireGuard Portal.   For example:   
    (&(objectClass=organizationalPerson)(!userAccountControl:1.2.840.113556.1.4.803:=2)(mail=*))\n
    •  
"},{"location":"documentation/configuration/overview/#disable_missing","title":"disable_missing","text":"
     
  • Default: (empty)
    •  
  • Description: If true, any user not found in LDAP (during sync) is disabled in WireGuard Portal.
    •  
"},{"location":"documentation/configuration/overview/#auto_re_enable","title":"auto_re_enable","text":"
     
  • Default: (empty)
    •  
  • Description: If true, users that where disabled because they were missing (see disable_missing) will be re-enabled once they are found again.
    •  
"},{"location":"documentation/configuration/overview/#registration_enabled_2","title":"registration_enabled","text":"
     
  • Default: (empty)
    •  
  • Description: If true, new user accounts are created in WireGuard Portal upon first login.
    •  
"},{"location":"documentation/configuration/overview/#log_user_info_2","title":"log_user_info","text":"
     
  • Default: (empty)
    •  
  • Description: If true, logs LDAP user data at the trace level upon login.
    •  
"},{"location":"documentation/configuration/overview/#web","title":"Web","text":"
The web section contains configuration options for the web server, including the listening address, session management, and CSRF protection. It is important to specify a valid external_url for the web server, especially if you are using a reverse proxy.  Without a valid external_url, the login process may fail due to CSRF protection.
"},{"location":"documentation/configuration/overview/#listening_address_1","title":"listening_address","text":"
     
  • Default: :8888
    •  
  • Description: The listening port of the web server.
    •  
"},{"location":"documentation/configuration/overview/#external_url","title":"external_url","text":"
     
  • Default: http://localhost:8888
    •  
  • Description: The URL where a client can access WireGuard Portal. This URL is used for generating links in emails and for performing OAUTH redirects. Important: If you are using a reverse proxy, set this to the external URL of the reverse proxy, otherwise login will fail. If you access the portal via IP address, set this to the IP address of the server.
    •  
"},{"location":"documentation/configuration/overview/#site_company_name","title":"site_company_name","text":"
     
  • Default: WireGuard Portal
    •  
  • Description: The company name that is shown at the bottom of the web frontend.
    •  
"},{"location":"documentation/configuration/overview/#site_title","title":"site_title","text":"
     
  • Default: WireGuard Portal
    •  
  • Description: The title that is shown in the web frontend.
    •  
"},{"location":"documentation/configuration/overview/#session_identifier","title":"session_identifier","text":"
     
  • Default: wgPortalSession
    •  
  • Description: The session identifier for the web frontend.
    •  
"},{"location":"documentation/configuration/overview/#session_secret","title":"session_secret","text":"
     
  • Default: very_secret
    •  
  • Description: The session secret for the web frontend.
    •  
"},{"location":"documentation/configuration/overview/#csrf_secret","title":"csrf_secret","text":"
     
  • Default: extremely_secret
    •  
  • Description: The CSRF secret.
    •  
"},{"location":"documentation/configuration/overview/#request_logging","title":"request_logging","text":"
     
  • Default: false
    •  
  • Description: Log all HTTP requests.
    •  
"},{"location":"documentation/configuration/overview/#cert_file","title":"cert_file","text":"
     
  • Default: (empty)
    •  
  • Description: (Optional) Path to the TLS certificate file.
    •  
"},{"location":"documentation/configuration/overview/#key_file","title":"key_file","text":"
     
  • Default: (empty)
    •  
  • Description: (Optional) Path to the TLS certificate key file.
    •  
"},{"location":"documentation/configuration/overview/#webhook","title":"Webhook","text":"
The webhook section allows you to configure a webhook that is called on certain events in WireGuard Portal. A JSON object is sent in a POST request to the webhook URL with the following structure: 
{\n  \"event\": \"peer_created\",\n  \"entity\": \"peer\",\n  \"identifier\": \"the-peer-identifier\",\n  \"payload\": {\n    // The payload of the event, e.g. peer data.\n    // Check the API documentation for the exact structure.\n  }\n}\n
"},{"location":"documentation/configuration/overview/#url_1","title":"url","text":"
     
  • Default: (empty)
    •  
  • Description: The POST endpoint to which the webhook is sent. The URL must be reachable from the WireGuard Portal server. If the URL is empty, the webhook is disabled.
    •  
"},{"location":"documentation/configuration/overview/#authentication","title":"authentication","text":"
     
  • Default: (empty)
    •  
  • Description: The Authorization header for the webhook endpoint. The value is send as-is in the header. For example: Bearer <token>.
    •  
"},{"location":"documentation/configuration/overview/#timeout","title":"timeout","text":"
     
  • Default: 10s
    •  
  • Description: The timeout for the webhook request. If the request takes longer than this, it is aborted.
    •  
"},{"location":"documentation/getting-started/binaries/","title":"Binaries","text":"
Starting from v2, each release includes compiled binaries for supported platforms. These binary versions can be manually downloaded and installed.
"},{"location":"documentation/getting-started/binaries/#download","title":"Download","text":"
With curl:
 
curl -L -o wg-portal https://github.com/h44z/wg-portal/releases/download/${WG_PORTAL_VERSION}/wg-portal_linux_amd64 \n
 
With wget:
 
wget -O wg-portal https://github.com/h44z/wg-portal/releases/download/${WG_PORTAL_VERSION}/wg-portal_linux_amd64\n
 
with gh cli:
 
gh release download ${WG_PORTAL_VERSION} --repo h44z/wg-portal --output wg-portal --pattern '*amd64'\n
"},{"location":"documentation/getting-started/binaries/#install","title":"Install","text":"
sudo mkdir -p /opt/wg-portal\nsudo install wg-portal /opt/wg-portal/\n
"},{"location":"documentation/getting-started/binaries/#unreleased","title":"Unreleased","text":"
Unreleased versions could be downloaded from GitHub Workflow artifacts also.
"},{"location":"documentation/getting-started/docker/","title":"Docker","text":""},{"location":"documentation/getting-started/docker/#image-usage","title":"Image Usage","text":"
The WireGuard Portal Docker image is available on both Docker Hub and GitHub Container Registry. It is built on the official Alpine Linux base image and comes pre-packaged with all necessary WireGuard dependencies.
 
This container allows you to establish WireGuard VPN connections without relying on a host system that supports WireGuard or using the linuxserver/wireguard Docker image.
 
The recommended method for deploying WireGuard Portal is via Docker Compose for ease of configuration and management.
 
A sample docker-compose.yml (managing WireGuard interfaces directly on the host) is provided below:
 
---\nservices:\n  wg-portal:\n    image: wgportal/wg-portal:latest\n    container_name: wg-portal\n    restart: unless-stopped\n    logging:\n      options:\n        max-size: \"10m\"\n        max-file: \"3\"\n    cap_add:\n      - NET_ADMIN\n    network_mode: \"host\"\n    volumes:\n      - /etc/wireguard:/etc/wireguard\n      - ./data:/app/data\n      - ./config:/app/config\n
 
By default, the webserver is listening on port 8888.
 
Volumes for /app/data and /app/config should be used ensure data persistence across container restarts.
"},{"location":"documentation/getting-started/docker/#wireguard-interface-handling","title":"WireGuard Interface Handling","text":"
WireGuard Portal supports managing WireGuard interfaces through three distinct deployment methods, providing flexibility based on your system architecture and operational preferences:
 
     
  •  
    Directly on the host system:     WireGuard Portal can control WireGuard interfaces natively on the host, without using containers.     This setup is ideal for environments where direct access to system networking is preferred.    To use this method, you need to set the network mode to host in your docker-compose.yml file.    
    services:\n  wg-portal:\n    ...\n    network_mode: \"host\"\n    ...\n
     
    •  
  •  
    Within the WireGuard Portal Docker container:     WireGuard interfaces can be managed directly from within the WireGuard Portal container itself.    This is the recommended approach when running WireGuard Portal via Docker, as it encapsulates all functionality in a single, portable container without requiring a separate WireGuard host or image.    
    services:\n  wg-portal:\n    image: wgportal/wg-portal:latest\n    container_name: wg-portal\n    ...\n    cap_add:\n      - NET_ADMIN\n    ports:\n      # WireGuard port, needs to match the port in wg-portal interface config (add one port mapping for each interface)\n      - \"51820:51820/udp\" \n      # Web UI port\n      - \"8888:8888/tcp\"\n    sysctls:\n      - net.ipv4.conf.all.src_valid_mark=1\n    volumes:\n      - ./wg/data:/app/data\n      - ./wg/config:/app/config\n
     
    •  
  •  
    Via a separate Docker container:     WireGuard Portal can interface with and control WireGuard running in another Docker container, such as the linuxserver/wireguard image.    This method is useful in setups that already use linuxserver/wireguard or where you want to isolate the VPN backend from the portal frontend.    For this, you need to set the network mode to service:wireguard in your docker-compose.yml file, wireguard is the service name of your WireGuard container.    
    services:\n  wg-portal:\n    image: wgportal/wg-portal:latest\n    container_name: wg-portal\n    ...\n    cap_add:\n      - NET_ADMIN\n    network_mode: \"service:wireguard\" # So we ensure to stay on the same network as the wireguard container.\n    volumes:\n      - ./wg/etc:/etc/wireguard\n      - ./wg/data:/app/data\n      - ./wg/config:/app/config\n\n  wireguard:\n    image: lscr.io/linuxserver/wireguard:latest\n    container_name: wireguard\n    restart: unless-stopped\n    cap_add:\n      - NET_ADMIN\n    ports:\n      - \"51820:51820/udp\" # WireGuard port, needs to match the port in wg-portal interface config\n      - \"8888:8888/tcp\" # Noticed that the port of the web UI is exposed in the wireguard container.\n    volumes:\n      - ./wg/etc:/config/wg_confs # We share the configuration (wgx.conf) between wg-portal and wireguard\n    sysctls:\n      - net.ipv4.conf.all.src_valid_mark=1\n
        As the linuxserver/wireguard image uses wg-quick to manage the interfaces, you need to have at least the following configuration set for WireGuard Portal:    
    core:\n  # The WireGuard container uses wg-quick to manage the WireGuard interfaces - this conflicts with WireGuard Portal during startup.\n  # To avoid this, we need to set the restore_state option to false so that wg-quick can create the interfaces.\n  restore_state: false\n  # Usually, there are no existing interfaces in the WireGuard container, so we can set this to false.\n  import_existing: false\nadvanced:\n  # WireGuard Portal needs to export the WireGuard configuration as wg-quick config files so that the WireGuard container can use them.\n  config_storage_path: /etc/wireguard/\n
     
    •  
"},{"location":"documentation/getting-started/docker/#image-versioning","title":"Image Versioning","text":"
All images are hosted on Docker Hub at https://hub.docker.com/r/wgportal/wg-portal or in the GitHub Container Registry. There are three types of tags in the repository:
"},{"location":"documentation/getting-started/docker/#semantic-versioned-tags","title":"Semantic versioned tags","text":"
For example, 2.0.0-rc.1 or v2.0.0-rc.1.
 
These are official releases of WireGuard Portal. They correspond to the GitHub tags that we make, and you can see the release notes for them here: https://github.com/h44z/wg-portal/releases.
 
Once these tags show up in this repository, they will never change.
 
For production deployments of WireGuard Portal, we strongly recommend using one of these tags, e.g. wgportal/wg-portal:1.0.19, instead of the latest or canary tags.
 
If you only want to stay at the same major or major+minor version, use either v[MAJOR] or [MAJOR].[MINOR] tags. For example v1 or 1.0.
 
Version 1 is currently stable, version 2 is in development.
"},{"location":"documentation/getting-started/docker/#latest","title":"latest","text":"
This is the most recent build to master! It changes a lot and is very unstable.
 
We recommend that you don't use it except for development purposes.
"},{"location":"documentation/getting-started/docker/#branch-tags","title":"Branch tags","text":"
For each commit in the master and the stable branch, a corresponding Docker image is build. These images use the master or stable tags.
"},{"location":"documentation/getting-started/docker/#configuration","title":"Configuration","text":"
You can configure WireGuard Portal using a YAML configuration file. The filepath of the YAML configuration file defaults to /app/config/config.yml. It is possible to override the configuration filepath using the environment variable WG_PORTAL_CONFIG.
 
By default, WireGuard Portal uses an SQLite database. The database is stored in /app/data/sqlite.db.
 
You should mount those directories as a volume:
 
     
  • /app/data
    •  
  • /app/config
    •  
 
A detailed description of the configuration options can be found here.
 
If you want to access configuration files in wg-quick format, you can mount the /etc/wireguard directory to a location of your choice. Also enable the config_storage_path option in the configuration file: 
advanced:\n  config_storage_path: /etc/wireguard\n
"},{"location":"documentation/getting-started/helm/","title":"Helm","text":""},{"location":"documentation/getting-started/helm/#installing-the-chart","title":"Installing the Chart","text":"
To install the chart with the release name wg-portal:
 
helm install wg-portal oci://ghcr.io/h44z/charts/wg-portal\n
 
This command deploy wg-portal on the Kubernetes cluster in the default configuration. The Values section lists the parameters that can be configured during installation.
"},{"location":"documentation/getting-started/helm/#values","title":"Values","text":"Key Type Default Description nameOverride string \"\" Partially override resource names (adds suffix) fullnameOverride string \"\" Fully override resource names extraDeploy list [] Array of extra objects to deploy with the release config.advanced tpl/object {} Advanced configuration options. config.auth tpl/object {} Auth configuration options. config.core tpl/object {} Core configuration options. If external admins in auth are defined and there are no admin_user and admin_password defined here, the default admin account will be disabled. config.database tpl/object {} Database configuration options config.mail tpl/object {} Mail configuration options config.statistics tpl/object {} Statistics configuration options config.web tpl/object {} Web configuration options. listening_address will be set automatically from service.web.port. external_url is required to enable ingress and certificate resources. revisionHistoryLimit string 10 The number of old ReplicaSets to retain to allow rollback. workloadType string \"Deployment\" Workload type - Deployment or StatefulSet strategy object {\"type\":\"RollingUpdate\"} Update strategy for the workload Valid values are:  RollingUpdate or Recreate for Deployment,  RollingUpdate or OnDelete for StatefulSet image.repository string \"ghcr.io/h44z/wg-portal\" Image repository image.pullPolicy string \"IfNotPresent\" Image pull policy image.tag string \"\" Overrides the image tag whose default is the chart appVersion imagePullSecrets list [] Image pull secrets podAnnotations tpl/object {} Extra annotations to add to the pod podLabels object {} Extra labels to add to the pod podSecurityContext object {} Pod Security Context securityContext.capabilities.add list [\"NET_ADMIN\"] Add capabilities to the container initContainers tpl/list [] Pod init containers sidecarContainers tpl/list [] Pod sidecar containers dnsPolicy string \"ClusterFirst\" Set DNS policy for the pod. Valid values are ClusterFirstWithHostNet, ClusterFirst, Default or None. restartPolicy string \"Always\" Restart policy for all containers within the pod. Valid values are Always, OnFailure or Never. hostNetwork string false. Use the host's network namespace. resources object {} Resources requests and limits command list [] Overwrite pod command args list [] Additional pod arguments env tpl/list [] Additional environment variables envFrom tpl/list [] Additional environment variables from a secret or configMap livenessProbe object {} Liveness probe configuration readinessProbe object {} Readiness probe configuration startupProbe object {} Startup probe configuration volumes tpl/list [] Additional volumes volumeMounts tpl/list [] Additional volumeMounts nodeSelector object {\"kubernetes.io/os\":\"linux\"} Node Selector configuration tolerations list [] Tolerations configuration affinity object {} Affinity configuration service.mixed.enabled bool false Whether to create a single service for the web and wireguard interfaces service.mixed.type string \"LoadBalancer\" Service type service.web.annotations object {} Annotations for the web service service.web.type string \"ClusterIP\" Web service type service.web.port int 8888 Web service port Used for the web interface listener service.web.appProtocol string \"http\" Web service appProtocol. Will be auto set to https if certificate is enabled. service.wireguard.annotations object {} Annotations for the WireGuard service service.wireguard.type string \"LoadBalancer\" Wireguard service type service.wireguard.ports list [51820] Wireguard service ports. Exposes the WireGuard ports for created interfaces. Lowerest port is selected as start port for the first interface. Increment next port by 1 for each additional interface. service.metrics.port int 8787 ingress.enabled bool false Specifies whether an ingress resource should be created ingress.className string \"\" Ingress class name ingress.annotations object {} Ingress annotations ingress.tls bool false Ingress TLS configuration. Enable certificate resource or add ingress annotation to create required secret certificate.enabled bool false Specifies whether a certificate resource should be created. If enabled, certificate will be used for the web. certificate.issuer.name string \"\" Certificate issuer name certificate.issuer.kind string \"\" Certificate issuer kind (ClusterIssuer or Issuer) certificate.issuer.group string \"cert-manager.io\" Certificate issuer group certificate.duration string \"\" Optional. Documentation certificate.renewBefore string \"\" Optional. Documentation certificate.commonName string \"\" Optional. Documentation certificate.emailAddresses list [] Optional. Documentation certificate.ipAddresses list [] Optional. Documentation certificate.keystores object {} Optional. Documentation certificate.privateKey object {} Optional. Documentation certificate.secretTemplate object {} Optional. Documentation certificate.subject object {} Optional. Documentation certificate.uris list [] Optional. Documentation certificate.usages list [] Optional. Documentation persistence.enabled bool false Specifies whether an persistent volume should be created persistence.annotations object {} Persistent Volume Claim annotations persistence.storageClass string \"\" Persistent Volume storage class. If undefined (the default) cluster's default provisioner will be used. persistence.accessMode string \"ReadWriteOnce\" Persistent Volume Access Mode persistence.size string \"1Gi\" Persistent Volume size persistence.volumeName string \"\" Persistent Volume Name (optional) serviceAccount.create bool true Specifies whether a service account should be created serviceAccount.annotations object {} Service account annotations serviceAccount.automount bool false Automatically mount a ServiceAccount's API credentials serviceAccount.name string \"\" The name of the service account to use. If not set and create is true, a name is generated using the fullname template monitoring.enabled bool false Enable Prometheus monitoring. monitoring.apiVersion string \"monitoring.coreos.com/v1\" API version of the Prometheus resource. Use azmonitoring.coreos.com/v1 for Azure Managed Prometheus. monitoring.kind string \"PodMonitor\" Kind of the Prometheus resource. Could be PodMonitor or ServiceMonitor. monitoring.labels object {} Resource labels. monitoring.annotations object {} Resource annotations. monitoring.interval string 1m Interval at which metrics should be scraped. If not specified config.statistics.data_collection_interval interval is used. monitoring.metricRelabelings list [] Relabelings to samples before ingestion. monitoring.relabelings list [] Relabelings to samples before scraping. monitoring.scrapeTimeout string \"\" Timeout after which the scrape is ended If not specified, the Prometheus global scrape interval is used. monitoring.jobLabel string \"\" The label to use to retrieve the job name from. monitoring.podTargetLabels object {} Transfers labels on the Kubernetes Pod onto the target. monitoring.dashboard.enabled bool false Enable Grafana dashboard. monitoring.dashboard.annotations object {} Annotations for the dashboard ConfigMap. monitoring.dashboard.labels object {} Additional labels for the dashboard ConfigMap. monitoring.dashboard.namespace string \"\" Dashboard ConfigMap namespace Overrides the namespace for the dashboard ConfigMap."},{"location":"documentation/getting-started/sources/","title":"Sources","text":"
To build the application from source files, use the Makefile provided in the repository.
"},{"location":"documentation/getting-started/sources/#requirements","title":"Requirements","text":"
     
  • Git
    •  
  • Make
    •  
  • Go: >=1.24.0
    •  
  • Node.js with npm: node>=18, npm>=9
    •  
"},{"location":"documentation/getting-started/sources/#build","title":"Build","text":"
# Get source code\ngit clone https://github.com/h44z/wg-portal -b ${WG_PORTAL_VERSION:-master} --depth 1\ncd wg-portal\n# Build the frontend\nmake frontend\n# Build the backend\nmake build\n
"},{"location":"documentation/getting-started/sources/#install","title":"Install","text":"
Compiled binary will be available in ./dist directory.  For installation instructions, check the Binaries section.
"},{"location":"documentation/monitoring/prometheus/","title":"Monitoring","text":"
By default, WG-Portal exposes Prometheus metrics on port 8787 if interface/peer statistic data collection is enabled.
"},{"location":"documentation/monitoring/prometheus/#exposed-metrics","title":"Exposed Metrics","text":"Metric Type Description wireguard_interface_received_bytes_total gauge Bytes received through the interface. wireguard_interface_sent_bytes_total gauge Bytes sent through the interface. wireguard_peer_last_handshake_seconds gauge Seconds from the last handshake with the peer. wireguard_peer_received_bytes_total gauge Bytes received from the peer. wireguard_peer_sent_bytes_total gauge Bytes sent to the peer. wireguard_peer_up gauge Peer connection state (boolean: 1/0)."},{"location":"documentation/monitoring/prometheus/#prometheus-config","title":"Prometheus Config","text":"
Add following scrape job to your Prometheus config file:
 
# prometheus.yaml\nscrape_configs:\n  - job_name: wg-portal\n    scrape_interval: 60s\n    static_configs:\n      - targets:\n          - localhost:8787 # Change localhost to IP Address or hostname with WG-Portal\n
"},{"location":"documentation/monitoring/prometheus/#grafana-dashboard","title":"Grafana Dashboard","text":"
You may import dashboard.json into your Grafana instance.
 
"},{"location":"documentation/rest-api/api-doc/","title":"REST API","text":""},{"location":"documentation/upgrade/v1/","title":"Upgrade","text":"
For production deployments of WireGuard Portal, we strongly recommend using version 1. If you want to use version 2, please be aware that it is still a release candidate and not yet fully stable.
"},{"location":"documentation/upgrade/v1/#upgrade-from-v1-to-v2","title":"Upgrade from v1 to v2","text":"
 Before upgrading from V1, make sure that you have a backup of your currently working configuration files and database!
 
To start the upgrade process, start the wg-portal binary with the -migrateFrom parameter. The configuration (config.yml) for WireGuard Portal must be updated and valid before starting the upgrade.
 
To upgrade from a previous SQLite database, start wg-portal like:
 
./wg-portal-amd64 -migrateFrom=old_wg_portal.db\n
 
You can also specify the database type using the parameter -migrateFromType, supported types: mysql, mssql, postgres or sqlite. For example:
 
./wg-portal-amd64 -migrateFromType=mysql -migrateFrom='user:pass@tcp(1.2.3.4:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local'\n
 
The upgrade will transform the old, existing database and store the values in the new database specified in the config.yml configuration file. Ensure that the new database does not contain any data!
 
If you are using Docker, you can adapt the docker-compose.yml file to start the upgrade process:
 
services:\n  wg-portal:\n    image: wgportal/wg-portal:latest\n    # ... other settings\n    restart: no\n    command: [\"-migrateFrom=/app/data/wg_portal.db\"]\n
"}]}
\ No newline at end of file
+{"config":{"lang":["en"],"separator":"[\\s\\-]+","pipeline":["stopWordFilter"]},"docs":[{"location":"documentation/overview/","title":"Overview","text":"
WireGuard Portal is a simple, web-based configuration portal for WireGuard server management. The portal uses the WireGuard wgctrl library to manage existing VPN interfaces. This allows for the seamless activation or deactivation of new users without disturbing existing VPN connections.
 
The configuration portal supports using a database (SQLite, MySQL, MsSQL or Postgres), OAuth or LDAP (Active Directory or OpenLDAP) as a user source for authentication and profile data.
"},{"location":"documentation/overview/#features","title":"Features","text":"
     
  • Self-hosted - the whole application is a single binary
    •  
  • Responsive multi-language web UI written in Vue.js
    •  
  • Automatically selects IP from the network pool assigned to the client
    •  
  • QR-Code for convenient mobile client configuration
    •  
  • Sends email to the client with QR-code and client config
    •  
  • Enable / Disable clients seamlessly
    •  
  • Generation of wg-quick configuration file (wgX.conf) if required
    •  
  • User authentication (database, OAuth, or LDAP)
    •  
  • IPv6 ready
    •  
  • Docker ready
    •  
  • Can be used with existing WireGuard setups
    •  
  • Support for multiple WireGuard interfaces
    •  
  • Peer Expiry Feature
    •  
  • Handles route and DNS settings like wg-quick does
    •  
  • Exposes Prometheus metrics for monitoring and alerting
    •  
  • REST API for management and client deployment
    •  
  • Webhook for custom actions on peer, interface or user updates
    •  
"},{"location":"documentation/configuration/examples/","title":"Examples","text":"
Below are some sample YAML configurations demonstrating how to override some default values.
"},{"location":"documentation/configuration/examples/#basic","title":"Basic","text":"
core:\n  admin_user: test@example.com\n  admin_password: password\n  admin_api_token: super-s3cr3t-api-token-or-a-UUID\n  import_existing: false\n  create_default_peer: true\n  self_provisioning_allowed: true\n\nweb:\n  site_title: My WireGuard Server\n  site_company_name: My Company\n  listening_address: :8080\n  external_url: https://my.externa-domain.com\n  csrf_secret: super-s3cr3t-csrf\n  session_secret: super-s3cr3t-session\n  request_logging: true\n\nadvanced:\n  log_level: trace\n  log_pretty: true\n  log_json: false\n  config_storage_path: /etc/wireguard\n  expiry_check_interval: 5m\n\ndatabase:\n  debug: true\n  type: sqlite\n  dsn: data/sqlite.db\n  encryption_passphrase: change-this-s3cr3t-encryption-passphrase\n
"},{"location":"documentation/configuration/examples/#ldap-authentication-and-synchronization","title":"LDAP Authentication and Synchronization","text":"
# ... (basic configuration)\n\nauth:\n  ldap:\n    # a sample LDAP provider with user sync enabled\n    - id: ldap\n      provider_name: Active Directory\n      url: ldap://srv-ad1.company.local:389\n      bind_user: ldap_wireguard@company.local\n      bind_pass: super-s3cr3t-ldap\n      base_dn: DC=COMPANY,DC=LOCAL\n      login_filter: (&(objectClass=organizationalPerson)(mail={{login_identifier}})(!userAccountControl:1.2.840.113556.1.4.803:=2))\n      sync_interval: 15m\n      sync_filter: (&(objectClass=organizationalPerson)(!userAccountControl:1.2.840.113556.1.4.803:=2)(mail=*))\n      disable_missing: true\n      field_map:\n        user_identifier: sAMAccountName\n        email: mail\n        firstname: givenName\n        lastname: sn\n        phone: telephoneNumber\n        department: department\n        memberof: memberOf\n      admin_group: CN=WireGuardAdmins,OU=Some-OU,DC=COMPANY,DC=LOCAL\n      registration_enabled: true\n      log_user_info: true\n
"},{"location":"documentation/configuration/examples/#openid-connect-oidc-authentication","title":"OpenID Connect (OIDC) Authentication","text":"
# ... (basic configuration)\n\nauth:\n  oidc:\n    # a sample Entra ID provider with environment variable substitution\n    - id: azure\n      provider_name: azure\n      display_name: Login with</br>Entra ID\n      registration_enabled: true\n      base_url: \"https://login.microsoftonline.com/${AZURE_TENANT_ID}/v2.0\"\n      client_id: \"${AZURE_CLIENT_ID}\"\n      client_secret: \"${AZURE_CLIENT_SECRET}\"\n      extra_scopes:\n        - profile\n        - email\n\n    # a sample provider where users with the attribute `wg_admin` set to `true` are considered as admins\n    - id: oidc-with-admin-attribute\n      provider_name: google\n      display_name: Login with</br>Google\n      base_url: https://accounts.google.com\n      client_id: the-client-id-1234.apps.googleusercontent.com\n      client_secret: A_CLIENT_SECRET\n      extra_scopes:\n        - https://www.googleapis.com/auth/userinfo.email\n        - https://www.googleapis.com/auth/userinfo.profile\n      field_map:\n        user_identifier: sub\n        email: email\n        firstname: given_name\n        lastname: family_name\n        phone: phone_number\n        department: department\n        is_admin: wg_admin\n      admin_mapping:\n        admin_value_regex: ^true$\n      registration_enabled: true\n      log_user_info: true\n\n    # a sample provider where users in the group `the-admin-group` are considered as admins\n    - id: oidc-with-admin-group\n      provider_name: google2\n      display_name: Login with</br>Google2\n      base_url: https://accounts.google.com\n      client_id: another-client-id-1234.apps.googleusercontent.com\n      client_secret: A_CLIENT_SECRET\n      extra_scopes:\n        - https://www.googleapis.com/auth/userinfo.email\n        - https://www.googleapis.com/auth/userinfo.profile\n      field_map:\n        user_identifier: sub\n        email: email\n        firstname: given_name\n        lastname: family_name\n        phone: phone_number\n        department: department\n        user_groups: groups\n      admin_mapping:\n        admin_group_regex: ^the-admin-group$\n      registration_enabled: true\n      log_user_info: true\n
"},{"location":"documentation/configuration/examples/#plain-oauth2-authentication","title":"Plain OAuth2 Authentication","text":"
# ... (basic configuration)\n\nauth:\n  oauth:\n    # a sample provider where users with the attribute `this-attribute-must-be-true` set to `true` or `True`\n    # are considered as admins\n    - id: google_plain_oauth-with-admin-attribute\n      provider_name: google3\n      display_name: Login with</br>Google3\n      client_id: another-client-id-1234.apps.googleusercontent.com\n      client_secret: A_CLIENT_SECRET\n      auth_url: https://accounts.google.com/o/oauth2/v2/auth\n      token_url: https://oauth2.googleapis.com/token\n      user_info_url: https://openidconnect.googleapis.com/v1/userinfo\n      scopes:\n        - openid\n        - email\n        - profile\n      field_map:\n        user_identifier: sub\n        email: email\n        firstname: name\n        is_admin: this-attribute-must-be-true\n      admin_mapping:\n        admin_value_regex: ^(True|true)$\n      registration_enabled: true\n\n    # a sample provider where either users with the attribute `this-attribute-must-be-true` set to `true` or \n    # users in the group `admin-group-name` are considered as admins\n    - id: google_plain_oauth_with_groups\n      provider_name: google4\n      display_name: Login with</br>Google4\n      client_id: another-client-id-1234.apps.googleusercontent.com\n      client_secret: A_CLIENT_SECRET\n      auth_url: https://accounts.google.com/o/oauth2/v2/auth\n      token_url: https://oauth2.googleapis.com/token\n      user_info_url: https://openidconnect.googleapis.com/v1/userinfo\n      scopes:\n        - openid\n        - email\n        - profile\n        - i-want-some-groups\n      field_map:\n        email: email\n        firstname: name\n        user_identifier: sub\n        is_admin: this-attribute-must-be-true\n        user_groups: groups\n      admin_mapping:\n        admin_value_regex: ^true$\n        admin_group_regex: ^admin-group-name$\n      registration_enabled: true\n      log_user_info: true\n
"},{"location":"documentation/configuration/overview/","title":"Overview","text":"
This page provides an overview of all available configuration options for WireGuard Portal.
 
You can supply these configurations in a YAML file (e.g. config.yaml) when starting the Portal. The path of the configuration file defaults to config/config.yaml (or config/config.yml) in the working directory of the executable. It is possible to override configuration filepath using the environment variable WG_PORTAL_CONFIG. For example: WG_PORTAL_CONFIG=/etc/wg-portal/config.yaml ./wg-portal. Also, environment variable substitution in config file is supported. Refer to syntax.
 
Configuration examples are available on the Examples page.
 Default configuration 
core:\n  admin_user: admin@wgportal.local\n  admin_password: wgportal\n  editable_keys: true\n  create_default_peer: false\n  create_default_peer_on_creation: false\n  re_enable_peer_after_user_enable: true\n  delete_peer_after_user_deleted: false\n  self_provisioning_allowed: false\n  import_existing: true\n  restore_state: true\n\nadvanced:\n  log_level: info\n  log_pretty: false\n  log_json: false\n  start_listen_port: 51820\n  start_cidr_v4: 10.11.12.0/24\n  start_cidr_v6: fdfd:d3ad:c0de:1234::0/64\n  use_ip_v6: true\n  config_storage_path: \"\"\n  expiry_check_interval: 15m\n  rule_prio_offset: 20000\n  api_admin_only: true\n\ndatabase:\n  debug: false\n  slow_query_threshold: \"0\"\n  type: sqlite\n  dsn: data/sqlite.db\n\nstatistics:\n  use_ping_checks: true\n  ping_check_workers: 10\n  ping_unprivileged: false\n  ping_check_interval: 1m\n  data_collection_interval: 1m\n  collect_interface_data: true\n  collect_peer_data: true\n  collect_audit_data: true\n  listening_address: :8787\n\nmail:\n  host: 127.0.0.1\n  port: 25\n  encryption: none\n  cert_validation: true\n  username: \"\"\n  password: \"\"\n  auth_type: plain\n  from: Wireguard Portal <noreply@wireguard.local>\n  link_only: false\n\nauth:\n  oidc: []\n  oauth: []\n  ldap: []\n\nweb:\n  listening_address: :8888\n  external_url: http://localhost:8888\n  site_company_name: WireGuard Portal\n  site_title: WireGuard Portal\n  session_identifier: wgPortalSession\n  session_secret: very_secret\n  csrf_secret: extremely_secret\n  request_logging: false\n  cert_file: \"\"\n  key_File: \"\"\n\nwebhook:\n  url: \"\"\n  authentication: \"\"\n  timeout: 10s\n
 
Below you will find sections like core, advanced, database, statistics, mail, auth, web and webhook. Each section describes the individual configuration keys, their default values, and a brief explanation of their purpose.
"},{"location":"documentation/configuration/overview/#core","title":"Core","text":"
These are the primary configuration options that control fundamental WireGuard Portal behavior. More advanced options are found in the subsequent Advanced section.
"},{"location":"documentation/configuration/overview/#admin_user","title":"admin_user","text":"
     
  • Default: admin@wgportal.local
    •  
  • Description: The administrator user. This user will be created as a default admin if it does not yet exist.
    •  
"},{"location":"documentation/configuration/overview/#admin_password","title":"admin_password","text":"
     
  • Default: wgportal
    •  
  • Description: The administrator password. The default password of wgportal should be changed immediately.
    •  
"},{"location":"documentation/configuration/overview/#admin_api_token","title":"admin_api_token","text":"
     
  • Default: (empty)
    •  
  • Description: An API token for the admin user. If a token is provided, the REST API can be accessed using this token. If empty, the API is initially disabled for the admin user.
    •  
"},{"location":"documentation/configuration/overview/#editable_keys","title":"editable_keys","text":"
     
  • Default: true
    •  
  • Description: Allow editing of WireGuard key-pairs directly in the UI.
    •  
"},{"location":"documentation/configuration/overview/#create_default_peer","title":"create_default_peer","text":"
     
  • Default: false
    •  
  • Description: If a user logs in for the first time with no existing peers, automatically create a new WireGuard peer for all server interfaces.
    •  
"},{"location":"documentation/configuration/overview/#create_default_peer_on_creation","title":"create_default_peer_on_creation","text":"
     
  • Default: false
    •  
  • Description: If an LDAP user is created (e.g., through LDAP sync) and has no peers, automatically create a new WireGuard peer for all server interfaces.
    •  
"},{"location":"documentation/configuration/overview/#re_enable_peer_after_user_enable","title":"re_enable_peer_after_user_enable","text":"
     
  • Default: true
    •  
  • Description: Re-enable all peers that were previously disabled if the associated user is re-enabled.
    •  
"},{"location":"documentation/configuration/overview/#delete_peer_after_user_deleted","title":"delete_peer_after_user_deleted","text":"
     
  • Default: false
    •  
  • Description: If a user is deleted, remove all linked peers. Otherwise, peers remain but are disabled.
    •  
"},{"location":"documentation/configuration/overview/#self_provisioning_allowed","title":"self_provisioning_allowed","text":"
     
  • Default: false
    •  
  • Description: Allow registered (non-admin) users to self-provision peers from their profile page.
    •  
"},{"location":"documentation/configuration/overview/#import_existing","title":"import_existing","text":"
     
  • Default: true
    •  
  • Description: On startup, import existing WireGuard interfaces and peers into WireGuard Portal.
    •  
"},{"location":"documentation/configuration/overview/#restore_state","title":"restore_state","text":"
     
  • Default: true
    •  
  • Description: Restore the WireGuard interface states (up/down) that existed before WireGuard Portal started.
    •  
"},{"location":"documentation/configuration/overview/#advanced","title":"Advanced","text":"
Additional or more specialized configuration options for logging and interface creation details.
"},{"location":"documentation/configuration/overview/#log_level","title":"log_level","text":"
     
  • Default: info
    •  
  • Description: The log level used by the application. Valid options are: trace, debug, info, warn, error.
    •  
"},{"location":"documentation/configuration/overview/#log_pretty","title":"log_pretty","text":"
     
  • Default: false
    •  
  • Description: If true, log messages are colorized and formatted for readability (pretty-print).
    •  
"},{"location":"documentation/configuration/overview/#log_json","title":"log_json","text":"
     
  • Default: false
    •  
  • Description: If true, log messages are structured in JSON format.
    •  
"},{"location":"documentation/configuration/overview/#start_listen_port","title":"start_listen_port","text":"
     
  • Default: 51820
    •  
  • Description: The first port to use when automatically creating new WireGuard interfaces.
    •  
"},{"location":"documentation/configuration/overview/#start_cidr_v4","title":"start_cidr_v4","text":"
     
  • Default: 10.11.12.0/24
    •  
  • Description: The initial IPv4 subnet to use when automatically creating new WireGuard interfaces.
    •  
"},{"location":"documentation/configuration/overview/#start_cidr_v6","title":"start_cidr_v6","text":"
     
  • Default: fdfd:d3ad:c0de:1234::0/64
    •  
  • Description: The initial IPv6 subnet to use when automatically creating new WireGuard interfaces.
    •  
"},{"location":"documentation/configuration/overview/#use_ip_v6","title":"use_ip_v6","text":"
     
  • Default: true
    •  
  • Description: Enable or disable IPv6 support.
    •  
"},{"location":"documentation/configuration/overview/#config_storage_path","title":"config_storage_path","text":"
     
  • Default: (empty)
    •  
  • Description: Path to a directory where wg-quick style configuration files will be stored (if you need local filesystem configs).
    •  
"},{"location":"documentation/configuration/overview/#expiry_check_interval","title":"expiry_check_interval","text":"
     
  • Default: 15m
    •  
  • Description: Interval after which existing peers are checked if they are expired. Format uses s, m, h, d for seconds, minutes, hours, days, see time.ParseDuration.
    •  
"},{"location":"documentation/configuration/overview/#rule_prio_offset","title":"rule_prio_offset","text":"
     
  • Default: 20000
    •  
  • Description: Offset for IP route rule priorities when configuring routing.
    •  
"},{"location":"documentation/configuration/overview/#route_table_offset","title":"route_table_offset","text":"
     
  • Default: 20000
    •  
  • Description: Offset for IP route table IDs when configuring routing.
    •  
"},{"location":"documentation/configuration/overview/#api_admin_only","title":"api_admin_only","text":"
     
  • Default: true
    •  
  • Description: If true, the public REST API is accessible only to admin users. The API docs live at /api/v1/doc.html.
    •  
"},{"location":"documentation/configuration/overview/#database","title":"Database","text":"
Configuration for the underlying database used by WireGuard Portal.  Supported databases include SQLite, MySQL, Microsoft SQL Server, and Postgres.
 
If sensitive values (like private keys) should be stored in an encrypted format, set the encryption_passphrase option.
"},{"location":"documentation/configuration/overview/#debug","title":"debug","text":"
     
  • Default: false
    •  
  • Description: If true, logs all database statements (verbose).
    •  
"},{"location":"documentation/configuration/overview/#slow_query_threshold","title":"slow_query_threshold","text":"
     
  • Default: \"0\"
    •  
  • Description: A time threshold (e.g., 100ms) above which queries are considered slow and logged as warnings. If zero, slow query logging is disabled. Format uses s, ms for seconds, milliseconds, see time.ParseDuration. The value must be a string.
    •  
"},{"location":"documentation/configuration/overview/#type","title":"type","text":"
     
  • Default: sqlite
    •  
  • Description: The database type. Valid options: sqlite, mssql, mysql, postgres.
    •  
"},{"location":"documentation/configuration/overview/#dsn","title":"dsn","text":"
     
  • Default: data/sqlite.db
    •  
  • Description: The Data Source Name (DSN) for connecting to the database.   For example:   
    user:pass@tcp(1.2.3.4:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local\n
    •  
"},{"location":"documentation/configuration/overview/#encryption_passphrase","title":"encryption_passphrase","text":"
     
  • Default: (empty)
    •  
  • Description: Passphrase for encrypting sensitive values such as private keys in the database. Encryption is only applied if this passphrase is set.   Important: Once you enable encryption by setting this passphrase, you cannot disable it or change it afterward.    New or updated records will be encrypted; existing data remains in plaintext until it\u2019s next modified.
    •  
"},{"location":"documentation/configuration/overview/#statistics","title":"Statistics","text":"
Controls how WireGuard Portal collects and reports usage statistics, including ping checks and Prometheus metrics.
"},{"location":"documentation/configuration/overview/#use_ping_checks","title":"use_ping_checks","text":"
     
  • Default: true
    •  
  • Description: Enable periodic ping checks to verify that peers remain responsive.
    •  
"},{"location":"documentation/configuration/overview/#ping_check_workers","title":"ping_check_workers","text":"
     
  • Default: 10
    •  
  • Description: Number of parallel worker processes for ping checks.
    •  
"},{"location":"documentation/configuration/overview/#ping_unprivileged","title":"ping_unprivileged","text":"
     
  • Default: false
    •  
  • Description: If false, ping checks run without root privileges. This is currently considered BETA.
    •  
"},{"location":"documentation/configuration/overview/#ping_check_interval","title":"ping_check_interval","text":"
     
  • Default: 1m
    •  
  • Description: Interval between consecutive ping checks for all peers. Format uses s, m, h, d for seconds, minutes, hours, days, see time.ParseDuration.
    •  
"},{"location":"documentation/configuration/overview/#data_collection_interval","title":"data_collection_interval","text":"
     
  • Default: 1m
    •  
  • Description: Interval between data collection cycles (bytes sent/received, handshake times, etc.). Format uses s, m, h, d for seconds, minutes, hours, days, see time.ParseDuration.
    •  
"},{"location":"documentation/configuration/overview/#collect_interface_data","title":"collect_interface_data","text":"
     
  • Default: true
    •  
  • Description: If true, collects interface-level data (bytes in/out) for monitoring and statistics.
    •  
"},{"location":"documentation/configuration/overview/#collect_peer_data","title":"collect_peer_data","text":"
     
  • Default: true
    •  
  • Description: If true, collects peer-level data (bytes, last handshake, endpoint, etc.).
    •  
"},{"location":"documentation/configuration/overview/#collect_audit_data","title":"collect_audit_data","text":"
     
  • Default: true
    •  
  • Description: If true, logs certain portal events (such as user logins) to the database.
    •  
"},{"location":"documentation/configuration/overview/#listening_address","title":"listening_address","text":"
     
  • Default: :8787
    •  
  • Description: Address and port for the integrated Prometheus metric server (e.g., :8787).
    •  
"},{"location":"documentation/configuration/overview/#mail","title":"Mail","text":"
Options for configuring email notifications or sending peer configurations via email.
"},{"location":"documentation/configuration/overview/#host","title":"host","text":"
     
  • Default: 127.0.0.1
    •  
  • Description: Hostname or IP of the SMTP server.
    •  
"},{"location":"documentation/configuration/overview/#port","title":"port","text":"
     
  • Default: 25
    •  
  • Description: Port number for the SMTP server.
    •  
"},{"location":"documentation/configuration/overview/#encryption","title":"encryption","text":"
     
  • Default: none
    •  
  • Description: SMTP encryption type. Valid values: none, tls, starttls.
    •  
"},{"location":"documentation/configuration/overview/#cert_validation","title":"cert_validation","text":"
     
  • Default: true
    •  
  • Description: If true, validate the SMTP server certificate (relevant if encryption = tls).
    •  
"},{"location":"documentation/configuration/overview/#username","title":"username","text":"
     
  • Default: (empty)
    •  
  • Description: Optional SMTP username for authentication.
    •  
"},{"location":"documentation/configuration/overview/#password","title":"password","text":"
     
  • Default: (empty)
    •  
  • Description: Optional SMTP password for authentication.
    •  
"},{"location":"documentation/configuration/overview/#auth_type","title":"auth_type","text":"
     
  • Default: plain
    •  
  • Description: SMTP authentication type. Valid values: plain, login, crammd5.
    •  
"},{"location":"documentation/configuration/overview/#from","title":"from","text":"
     
  • Default: Wireguard Portal <noreply@wireguard.local>
    •  
  • Description: The default \"From\" address when sending emails.
    •  
"},{"location":"documentation/configuration/overview/#link_only","title":"link_only","text":"
     
  • Default: false
    •  
  • Description: If true, emails only contain a link to WireGuard Portal, rather than attaching the full configuration.
    •  
"},{"location":"documentation/configuration/overview/#auth","title":"Auth","text":"
WireGuard Portal supports multiple authentication strategies, including OpenID Connect (oidc), OAuth (oauth), and LDAP (ldap). Each can have multiple providers configured. Below are the relevant keys.
"},{"location":"documentation/configuration/overview/#oidc","title":"OIDC","text":"
The oidc array contains a list of OpenID Connect providers.  Below are the properties for each OIDC provider entry inside auth.oidc:
"},{"location":"documentation/configuration/overview/#provider_name","title":"provider_name","text":"
     
  • Default: (empty)
    •  
  • Description: A unique name for this provider. Must not conflict with other providers.
    •  
"},{"location":"documentation/configuration/overview/#display_name","title":"display_name","text":"
     
  • Default: (empty)
    •  
  • Description: A user-friendly name shown on the login page (e.g., \"Login with Google\").
    •  
"},{"location":"documentation/configuration/overview/#base_url","title":"base_url","text":"
     
  • Default: (empty)
    •  
  • Description: The OIDC provider\u2019s base URL (e.g., https://accounts.google.com).
    •  
"},{"location":"documentation/configuration/overview/#client_id","title":"client_id","text":"
     
  • Default: (empty)
    •  
  • Description: The OAuth client ID from the OIDC provider.
    •  
"},{"location":"documentation/configuration/overview/#client_secret","title":"client_secret","text":"
     
  • Default: (empty)
    •  
  • Description: The OAuth client secret from the OIDC provider.
    •  
"},{"location":"documentation/configuration/overview/#extra_scopes","title":"extra_scopes","text":"
     
  • Default: (empty)
    •  
  • Description: A list of additional OIDC scopes (e.g., profile, email).
    •  
"},{"location":"documentation/configuration/overview/#field_map","title":"field_map","text":"
     
  • Default: (empty)
    •  
  • Description: Maps OIDC claims to WireGuard Portal user fields. 
    •  
  •  
    Available fields: user_identifier, email, firstname, lastname, phone, department, is_admin, user_groups.
     Field Typical OIDC Claim Explanation user_identifier sub or preferred_username A unique identifier for the user. Often the OIDC sub claim is used because it\u2019s guaranteed to be unique for the user within the IdP. Some providers also support preferred_username if it\u2019s unique. email email The user\u2019s email address as provided by the IdP. Not always verified, depending on IdP settings. firstname given_name The user\u2019s first name, typically provided by the IdP in the given_name claim. lastname family_name The user\u2019s last (family) name, typically provided by the IdP in the family_name claim. phone phone_number The user\u2019s phone number. This may require additional scopes/permissions from the IdP to access. department Custom claim (e.g., department) If the IdP can provide organizational data, it may store it in a custom claim. Adjust accordingly (e.g., department, org, or another attribute). is_admin Custom claim or derived role If the IdP returns a role or admin flag, you can map that to is_admin. Often this is managed through custom claims or group membership. user_groups groups or another custom claim A list of group memberships for the user. Some IdPs provide groups out of the box; others require custom claims or directory lookups. 
    •  
"},{"location":"documentation/configuration/overview/#admin_mapping","title":"admin_mapping","text":"
     
  • Default: (empty)
    •  
  • Description: WgPortal can grant a user admin rights by matching the value of the is_admin claim against a regular expression. Alternatively, a regular expression can be used to check if a user is member of a specific group listed in the user_group claim. The regular expressions are defined in admin_value_regex and admin_group_regex.
       
    • admin_value_regex: A regular expression to match the is_admin claim. By default, this expression matches the string \"true\" (^true$).
      •  
    • admin_group_regex: A regular expression to match the user_groups claim. Each entry in the user_groups claim is checked against this regex.
      •  
     
    •  
"},{"location":"documentation/configuration/overview/#registration_enabled","title":"registration_enabled","text":"
     
  • Default: (empty)
    •  
  • Description: If true, a new user will be created in WireGuard Portal if not already present.
    •  
"},{"location":"documentation/configuration/overview/#log_user_info","title":"log_user_info","text":"
     
  • Default: (empty)
    •  
  • Description: If true, OIDC user data is logged at the trace level upon login (for debugging).
    •  
"},{"location":"documentation/configuration/overview/#oauth","title":"OAuth","text":"
The oauth array contains a list of plain OAuth2 providers. Below are the properties for each OAuth provider entry inside auth.oauth:
"},{"location":"documentation/configuration/overview/#provider_name_1","title":"provider_name","text":"
     
  • Default: (empty)
    •  
  • Description: A unique name for this provider. Must not conflict with other providers.
    •  
"},{"location":"documentation/configuration/overview/#display_name_1","title":"display_name","text":"
     
  • Default: (empty)
    •  
  • Description: A user-friendly name shown on the login page.
    •  
"},{"location":"documentation/configuration/overview/#client_id_1","title":"client_id","text":"
     
  • Default: (empty)
    •  
  • Description: The OAuth client ID for the provider.
    •  
"},{"location":"documentation/configuration/overview/#client_secret_1","title":"client_secret","text":"
     
  • Default: (empty)
    •  
  • Description: The OAuth client secret for the provider.
    •  
"},{"location":"documentation/configuration/overview/#auth_url","title":"auth_url","text":"
     
  • Default: (empty)
    •  
  • Description: URL of the authentication endpoint.
    •  
"},{"location":"documentation/configuration/overview/#token_url","title":"token_url","text":"
     
  • Default: (empty)
    •  
  • Description: URL of the token endpoint.
    •  
"},{"location":"documentation/configuration/overview/#user_info_url","title":"user_info_url","text":"
     
  • Default: (empty)
    •  
  • Description: URL of the user information endpoint.
    •  
"},{"location":"documentation/configuration/overview/#scopes","title":"scopes","text":"
     
  • Default: (empty)
    •  
  • Description: A list of OAuth scopes.
    •  
"},{"location":"documentation/configuration/overview/#field_map_1","title":"field_map","text":"
     
  • Default: (empty)
    •  
  • Description: Maps OAuth attributes to WireGuard Portal fields.
    •  
  •  
    Available fields: user_identifier, email, firstname, lastname, phone, department, is_admin, user_groups.
     Field Typical Claim Explanation user_identifier sub or preferred_username A unique identifier for the user. Often the OIDC sub claim is used because it\u2019s guaranteed to be unique for the user within the IdP. Some providers also support preferred_username if it\u2019s unique. email email The user\u2019s email address as provided by the IdP. Not always verified, depending on IdP settings. firstname given_name The user\u2019s first name, typically provided by the IdP in the given_name claim. lastname family_name The user\u2019s last (family) name, typically provided by the IdP in the family_name claim. phone phone_number The user\u2019s phone number. This may require additional scopes/permissions from the IdP to access. department Custom claim (e.g., department) If the IdP can provide organizational data, it may store it in a custom claim. Adjust accordingly (e.g., department, org, or another attribute). is_admin Custom claim or derived role If the IdP returns a role or admin flag, you can map that to is_admin. Often this is managed through custom claims or group membership. user_groups groups or another custom claim A list of group memberships for the user. Some IdPs provide groups out of the box; others require custom claims or directory lookups. 
    •  
"},{"location":"documentation/configuration/overview/#admin_mapping_1","title":"admin_mapping","text":"
     
  • Default: (empty)
    •  
  • Description: WgPortal can grant a user admin rights by matching the value of the is_admin claim against a regular expression. Alternatively, a regular expression can be used to check if a user is member of a specific group listed in the user_group claim. The regular expressions are defined in admin_value_regex and admin_group_regex.
    •  
  • admin_value_regex: A regular expression to match the is_admin claim. By default, this expression matches the string \"true\" (^true$).
    •  
  • admin_group_regex: A regular expression to match the user_groups claim. Each entry in the user_groups claim is checked against this regex.
    •  
"},{"location":"documentation/configuration/overview/#registration_enabled_1","title":"registration_enabled","text":"
     
  • Default: (empty)
    •  
  • Description: If true, new users are created automatically on successful login.
    •  
"},{"location":"documentation/configuration/overview/#log_user_info_1","title":"log_user_info","text":"
     
  • Default: (empty)
    •  
  • Description: If true, logs user info at the trace level upon login.
    •  
"},{"location":"documentation/configuration/overview/#ldap","title":"LDAP","text":"
The ldap array contains a list of LDAP authentication providers. Below are the properties for each LDAP provider entry inside auth.ldap:
"},{"location":"documentation/configuration/overview/#provider_name_2","title":"provider_name","text":"
     
  • Default: (empty)
    •  
  • Description: A unique name for this provider. Must not conflict with other providers.
    •  
"},{"location":"documentation/configuration/overview/#url","title":"url","text":"
     
  • Default: (empty)
    •  
  • Description: The LDAP server URL (e.g., ldap://srv-ad01.company.local:389).
    •  
"},{"location":"documentation/configuration/overview/#start_tls","title":"start_tls","text":"
     
  • Default: (empty)
    •  
  • Description: If true, use STARTTLS to secure the LDAP connection.
    •  
"},{"location":"documentation/configuration/overview/#cert_validation_1","title":"cert_validation","text":"
     
  • Default: (empty)
    •  
  • Description: If true, validate the LDAP server\u2019s TLS certificate.
    •  
"},{"location":"documentation/configuration/overview/#tls_certificate_path","title":"tls_certificate_path","text":"
     
  • Default: (empty)
    •  
  • Description: Path to a TLS certificate if needed for LDAP connections.
    •  
"},{"location":"documentation/configuration/overview/#tls_key_path","title":"tls_key_path","text":"
     
  • Default: (empty)
    •  
  • Description: Path to the corresponding TLS certificate key.
    •  
"},{"location":"documentation/configuration/overview/#base_dn","title":"base_dn","text":"
     
  • Default: (empty)
    •  
  • Description: The base DN for user searches (e.g., DC=COMPANY,DC=LOCAL).
    •  
"},{"location":"documentation/configuration/overview/#bind_user","title":"bind_user","text":"
     
  • Default: (empty)
    •  
  • Description: The bind user for LDAP (e.g., company\\\\ldap_wireguard or ldap_wireguard@company.local).
    •  
"},{"location":"documentation/configuration/overview/#bind_pass","title":"bind_pass","text":"
     
  • Default: (empty)
    •  
  • Description: The bind password for LDAP authentication.
    •  
"},{"location":"documentation/configuration/overview/#field_map_2","title":"field_map","text":"
     
  • Default: (empty)
    •  
  •  
    Description: Maps LDAP attributes to WireGuard Portal fields.
     
       
    • Available fields: user_identifier, email, firstname, lastname, phone, department, memberof.
      •  
     WireGuard Portal Field Typical LDAP Attribute Short Description user_identifier sAMAccountName / uid Uniquely identifies the user within the LDAP directory. email mail / userPrincipalName Stores the user's primary email address. firstname givenName Contains the user's first (given) name. lastname sn Contains the user's last (surname) name. phone telephoneNumber / mobile Holds the user's phone or mobile number. department departmentNumber / ou Specifies the department or organizational unit of the user. memberof memberOf Lists the groups and roles to which the user belongs. 
    •  
"},{"location":"documentation/configuration/overview/#login_filter","title":"login_filter","text":"
     
  • Default: (empty)
    •  
  • Description: An LDAP filter to restrict which users can log in. Use {{login_identifier}} to insert the username.   For example:   
    (&(objectClass=organizationalPerson)(mail={{login_identifier}})(!userAccountControl:1.2.840.113556.1.4.803:=2))\n
    •  
"},{"location":"documentation/configuration/overview/#admin_group","title":"admin_group","text":"
     
  • Default: (empty)
    •  
  • Description: A specific LDAP group whose members are considered administrators in WireGuard Portal.   For example:   
    CN=WireGuardAdmins,OU=Some-OU,DC=YOURDOMAIN,DC=LOCAL\n
    •  
"},{"location":"documentation/configuration/overview/#sync_interval","title":"sync_interval","text":"
     
  • Default: (empty)
    •  
  • Description: How frequently (in duration, e.g. 30m) to synchronize users from LDAP. Empty or 0 disables sync. Format uses s, m, h, d for seconds, minutes, hours, days, see time.ParseDuration.   Only users that match the sync_filter are synchronized, if disable_missing is true, users not found in LDAP are disabled.
    •  
"},{"location":"documentation/configuration/overview/#sync_filter","title":"sync_filter","text":"
     
  • Default: (empty)
    •  
  • Description: An LDAP filter to select which users get synchronized into WireGuard Portal.   For example:   
    (&(objectClass=organizationalPerson)(!userAccountControl:1.2.840.113556.1.4.803:=2)(mail=*))\n
    •  
"},{"location":"documentation/configuration/overview/#disable_missing","title":"disable_missing","text":"
     
  • Default: (empty)
    •  
  • Description: If true, any user not found in LDAP (during sync) is disabled in WireGuard Portal.
    •  
"},{"location":"documentation/configuration/overview/#auto_re_enable","title":"auto_re_enable","text":"
     
  • Default: (empty)
    •  
  • Description: If true, users that where disabled because they were missing (see disable_missing) will be re-enabled once they are found again.
    •  
"},{"location":"documentation/configuration/overview/#registration_enabled_2","title":"registration_enabled","text":"
     
  • Default: (empty)
    •  
  • Description: If true, new user accounts are created in WireGuard Portal upon first login.
    •  
"},{"location":"documentation/configuration/overview/#log_user_info_2","title":"log_user_info","text":"
     
  • Default: (empty)
    •  
  • Description: If true, logs LDAP user data at the trace level upon login.
    •  
"},{"location":"documentation/configuration/overview/#web","title":"Web","text":"
The web section contains configuration options for the web server, including the listening address, session management, and CSRF protection. It is important to specify a valid external_url for the web server, especially if you are using a reverse proxy.  Without a valid external_url, the login process may fail due to CSRF protection.
"},{"location":"documentation/configuration/overview/#listening_address_1","title":"listening_address","text":"
     
  • Default: :8888
    •  
  • Description: The listening port of the web server.
    •  
"},{"location":"documentation/configuration/overview/#external_url","title":"external_url","text":"
     
  • Default: http://localhost:8888
    •  
  • Description: The URL where a client can access WireGuard Portal. This URL is used for generating links in emails and for performing OAUTH redirects. Important: If you are using a reverse proxy, set this to the external URL of the reverse proxy, otherwise login will fail. If you access the portal via IP address, set this to the IP address of the server.
    •  
"},{"location":"documentation/configuration/overview/#site_company_name","title":"site_company_name","text":"
     
  • Default: WireGuard Portal
    •  
  • Description: The company name that is shown at the bottom of the web frontend.
    •  
"},{"location":"documentation/configuration/overview/#site_title","title":"site_title","text":"
     
  • Default: WireGuard Portal
    •  
  • Description: The title that is shown in the web frontend.
    •  
"},{"location":"documentation/configuration/overview/#session_identifier","title":"session_identifier","text":"
     
  • Default: wgPortalSession
    •  
  • Description: The session identifier for the web frontend.
    •  
"},{"location":"documentation/configuration/overview/#session_secret","title":"session_secret","text":"
     
  • Default: very_secret
    •  
  • Description: The session secret for the web frontend.
    •  
"},{"location":"documentation/configuration/overview/#csrf_secret","title":"csrf_secret","text":"
     
  • Default: extremely_secret
    •  
  • Description: The CSRF secret.
    •  
"},{"location":"documentation/configuration/overview/#request_logging","title":"request_logging","text":"
     
  • Default: false
    •  
  • Description: Log all HTTP requests.
    •  
"},{"location":"documentation/configuration/overview/#cert_file","title":"cert_file","text":"
     
  • Default: (empty)
    •  
  • Description: (Optional) Path to the TLS certificate file.
    •  
"},{"location":"documentation/configuration/overview/#key_file","title":"key_file","text":"
     
  • Default: (empty)
    •  
  • Description: (Optional) Path to the TLS certificate key file.
    •  
"},{"location":"documentation/configuration/overview/#webhook","title":"Webhook","text":"
The webhook section allows you to configure a webhook that is called on certain events in WireGuard Portal. A JSON object is sent in a POST request to the webhook URL with the following structure: 
{\n  \"event\": \"peer_created\",\n  \"entity\": \"peer\",\n  \"identifier\": \"the-peer-identifier\",\n  \"payload\": {\n    // The payload of the event, e.g. peer data.\n    // Check the API documentation for the exact structure.\n  }\n}\n
"},{"location":"documentation/configuration/overview/#url_1","title":"url","text":"
     
  • Default: (empty)
    •  
  • Description: The POST endpoint to which the webhook is sent. The URL must be reachable from the WireGuard Portal server. If the URL is empty, the webhook is disabled.
    •  
"},{"location":"documentation/configuration/overview/#authentication","title":"authentication","text":"
     
  • Default: (empty)
    •  
  • Description: The Authorization header for the webhook endpoint. The value is send as-is in the header. For example: Bearer <token>.
    •  
"},{"location":"documentation/configuration/overview/#timeout","title":"timeout","text":"
     
  • Default: 10s
    •  
  • Description: The timeout for the webhook request. If the request takes longer than this, it is aborted.
    •  
"},{"location":"documentation/getting-started/binaries/","title":"Binaries","text":"
Starting from v2, each release includes compiled binaries for supported platforms. These binary versions can be manually downloaded and installed.
"},{"location":"documentation/getting-started/binaries/#download","title":"Download","text":"
With curl:
 
curl -L -o wg-portal https://github.com/h44z/wg-portal/releases/download/${WG_PORTAL_VERSION}/wg-portal_linux_amd64 \n
 
With wget:
 
wget -O wg-portal https://github.com/h44z/wg-portal/releases/download/${WG_PORTAL_VERSION}/wg-portal_linux_amd64\n
 
with gh cli:
 
gh release download ${WG_PORTAL_VERSION} --repo h44z/wg-portal --output wg-portal --pattern '*amd64'\n
"},{"location":"documentation/getting-started/binaries/#install","title":"Install","text":"
sudo mkdir -p /opt/wg-portal\nsudo install wg-portal /opt/wg-portal/\n
"},{"location":"documentation/getting-started/binaries/#unreleased","title":"Unreleased","text":"
Unreleased versions could be downloaded from GitHub Workflow artifacts also.
"},{"location":"documentation/getting-started/docker/","title":"Docker","text":""},{"location":"documentation/getting-started/docker/#image-usage","title":"Image Usage","text":"
The WireGuard Portal Docker image is available on both Docker Hub and GitHub Container Registry. It is built on the official Alpine Linux base image and comes pre-packaged with all necessary WireGuard dependencies.
 
This container allows you to establish WireGuard VPN connections without relying on a host system that supports WireGuard or using the linuxserver/wireguard Docker image.
 
The recommended method for deploying WireGuard Portal is via Docker Compose for ease of configuration and management.
 
A sample docker-compose.yml (managing WireGuard interfaces directly on the host) is provided below:
 
---\nservices:\n  wg-portal:\n    image: wgportal/wg-portal:latest\n    container_name: wg-portal\n    restart: unless-stopped\n    logging:\n      options:\n        max-size: \"10m\"\n        max-file: \"3\"\n    cap_add:\n      - NET_ADMIN\n    network_mode: \"host\"\n    volumes:\n      # left side is the host path, right side is the container path\n      - /etc/wireguard:/etc/wireguard\n      - ./data:/app/data\n
 
By default, the webserver is listening on port 8888.
 
Volumes for /app/data and /app/config should be used ensure data persistence across container restarts.
"},{"location":"documentation/getting-started/docker/#wireguard-interface-handling","title":"WireGuard Interface Handling","text":"
WireGuard Portal supports managing WireGuard interfaces through three distinct deployment methods, providing flexibility based on your system architecture and operational preferences:
 
     
  •  
    Directly on the host system:     WireGuard Portal can control WireGuard interfaces natively on the host, without using containers.     This setup is ideal for environments where direct access to system networking is preferred.    To use this method, you need to set the network mode to host in your docker-compose.yml file.    
    services:\n  wg-portal:\n    ...\n    network_mode: \"host\"\n    ...\n
     
    •  
  •  
    Within the WireGuard Portal Docker container:     WireGuard interfaces can be managed directly from within the WireGuard Portal container itself.    This is the recommended approach when running WireGuard Portal via Docker, as it encapsulates all functionality in a single, portable container without requiring a separate WireGuard host or image.    
    services:\n  wg-portal:\n    image: wgportal/wg-portal:latest\n    container_name: wg-portal\n    ...\n    cap_add:\n      - NET_ADMIN\n    ports:\n      # host port : container port\n      # WireGuard port, needs to match the port in wg-portal interface config (add one port mapping for each interface)\n      - \"51820:51820/udp\" \n      # Web UI port\n      - \"8888:8888/tcp\"\n    sysctls:\n      - net.ipv4.conf.all.src_valid_mark=1\n    volumes:\n      # host path : container path\n      - ./wg/data:/app/data\n      - ./wg/config:/app/config\n
     
    •  
  •  
    Via a separate Docker container:     WireGuard Portal can interface with and control WireGuard running in another Docker container, such as the linuxserver/wireguard image.    This method is useful in setups that already use linuxserver/wireguard or where you want to isolate the VPN backend from the portal frontend.    For this, you need to set the network mode to service:wireguard in your docker-compose.yml file, wireguard is the service name of your WireGuard container.    
    services:\n  wg-portal:\n    image: wgportal/wg-portal:latest\n    container_name: wg-portal\n    ...\n    cap_add:\n      - NET_ADMIN\n    network_mode: \"service:wireguard\" # So we ensure to stay on the same network as the wireguard container.\n    volumes:\n      # host path : container path\n      - ./wg/etc:/etc/wireguard\n      - ./wg/data:/app/data\n      - ./wg/config:/app/config\n\n  wireguard:\n    image: lscr.io/linuxserver/wireguard:latest\n    container_name: wireguard\n    restart: unless-stopped\n    cap_add:\n      - NET_ADMIN\n    ports:\n      # host port : container port\n      - \"51820:51820/udp\" # WireGuard port, needs to match the port in wg-portal interface config\n      - \"8888:8888/tcp\" # Noticed that the port of the web UI is exposed in the wireguard container.\n    volumes:\n      - ./wg/etc:/config/wg_confs # We share the configuration (wgx.conf) between wg-portal and wireguard\n    sysctls:\n      - net.ipv4.conf.all.src_valid_mark=1\n
        As the linuxserver/wireguard image uses wg-quick to manage the interfaces, you need to have at least the following configuration set for WireGuard Portal:    
    core:\n  # The WireGuard container uses wg-quick to manage the WireGuard interfaces - this conflicts with WireGuard Portal during startup.\n  # To avoid this, we need to set the restore_state option to false so that wg-quick can create the interfaces.\n  restore_state: false\n  # Usually, there are no existing interfaces in the WireGuard container, so we can set this to false.\n  import_existing: false\nadvanced:\n  # WireGuard Portal needs to export the WireGuard configuration as wg-quick config files so that the WireGuard container can use them.\n  config_storage_path: /etc/wireguard/\n
     
    •  
"},{"location":"documentation/getting-started/docker/#image-versioning","title":"Image Versioning","text":"
All images are hosted on Docker Hub at https://hub.docker.com/r/wgportal/wg-portal or in the GitHub Container Registry. There are three types of tags in the repository:
"},{"location":"documentation/getting-started/docker/#semantic-versioned-tags","title":"Semantic versioned tags","text":"
For example, 2.0.0-rc.1 or v2.0.0-rc.1.
 
These are official releases of WireGuard Portal. They correspond to the GitHub tags that we make, and you can see the release notes for them here: https://github.com/h44z/wg-portal/releases.
 
Once these tags show up in this repository, they will never change.
 
For production deployments of WireGuard Portal, we strongly recommend using one of these tags, e.g. wgportal/wg-portal:1.0.19, instead of the latest or canary tags.
 
If you only want to stay at the same major or major+minor version, use either v[MAJOR] or [MAJOR].[MINOR] tags. For example v1 or 1.0.
 
Version 1 is currently stable, version 2 is in development.
"},{"location":"documentation/getting-started/docker/#latest","title":"latest","text":"
This is the most recent build to master! It changes a lot and is very unstable.
 
We recommend that you don't use it except for development purposes.
"},{"location":"documentation/getting-started/docker/#branch-tags","title":"Branch tags","text":"
For each commit in the master and the stable branch, a corresponding Docker image is build. These images use the master or stable tags.
"},{"location":"documentation/getting-started/docker/#configuration","title":"Configuration","text":"
You can configure WireGuard Portal using a YAML configuration file. The filepath of the YAML configuration file defaults to /app/config/config.yaml. It is possible to override the configuration filepath using the environment variable WG_PORTAL_CONFIG.
 
By default, WireGuard Portal uses an SQLite database. The database is stored in /app/data/sqlite.db.
 
You should mount those directories as a volume:
 
     
  • /app/data
    •  
  • /app/config
    •  
 
A detailed description of the configuration options can be found here.
 
If you want to access configuration files in wg-quick format, you can mount the /etc/wireguard directory to a location of your choice. Also enable the config_storage_path option in the configuration file: 
advanced:\n  config_storage_path: /etc/wireguard\n
"},{"location":"documentation/getting-started/helm/","title":"Helm","text":""},{"location":"documentation/getting-started/helm/#installing-the-chart","title":"Installing the Chart","text":"
To install the chart with the release name wg-portal:
 
helm install wg-portal oci://ghcr.io/h44z/charts/wg-portal\n
 
This command deploy wg-portal on the Kubernetes cluster in the default configuration. The Values section lists the parameters that can be configured during installation.
"},{"location":"documentation/getting-started/helm/#values","title":"Values","text":"Key Type Default Description nameOverride string \"\" Partially override resource names (adds suffix) fullnameOverride string \"\" Fully override resource names extraDeploy list [] Array of extra objects to deploy with the release config.advanced tpl/object {} Advanced configuration options. config.auth tpl/object {} Auth configuration options. config.core tpl/object {} Core configuration options. If external admins in auth are defined and there are no admin_user and admin_password defined here, the default admin account will be disabled. config.database tpl/object {} Database configuration options config.mail tpl/object {} Mail configuration options config.statistics tpl/object {} Statistics configuration options config.web tpl/object {} Web configuration options. listening_address will be set automatically from service.web.port. external_url is required to enable ingress and certificate resources. revisionHistoryLimit string 10 The number of old ReplicaSets to retain to allow rollback. workloadType string \"Deployment\" Workload type - Deployment or StatefulSet strategy object {\"type\":\"RollingUpdate\"} Update strategy for the workload Valid values are:  RollingUpdate or Recreate for Deployment,  RollingUpdate or OnDelete for StatefulSet image.repository string \"ghcr.io/h44z/wg-portal\" Image repository image.pullPolicy string \"IfNotPresent\" Image pull policy image.tag string \"\" Overrides the image tag whose default is the chart appVersion imagePullSecrets list [] Image pull secrets podAnnotations tpl/object {} Extra annotations to add to the pod podLabels object {} Extra labels to add to the pod podSecurityContext object {} Pod Security Context securityContext.capabilities.add list [\"NET_ADMIN\"] Add capabilities to the container initContainers tpl/list [] Pod init containers sidecarContainers tpl/list [] Pod sidecar containers dnsPolicy string \"ClusterFirst\" Set DNS policy for the pod. Valid values are ClusterFirstWithHostNet, ClusterFirst, Default or None. restartPolicy string \"Always\" Restart policy for all containers within the pod. Valid values are Always, OnFailure or Never. hostNetwork string false. Use the host's network namespace. resources object {} Resources requests and limits command list [] Overwrite pod command args list [] Additional pod arguments env tpl/list [] Additional environment variables envFrom tpl/list [] Additional environment variables from a secret or configMap livenessProbe object {} Liveness probe configuration readinessProbe object {} Readiness probe configuration startupProbe object {} Startup probe configuration volumes tpl/list [] Additional volumes volumeMounts tpl/list [] Additional volumeMounts nodeSelector object {\"kubernetes.io/os\":\"linux\"} Node Selector configuration tolerations list [] Tolerations configuration affinity object {} Affinity configuration service.mixed.enabled bool false Whether to create a single service for the web and wireguard interfaces service.mixed.type string \"LoadBalancer\" Service type service.web.annotations object {} Annotations for the web service service.web.type string \"ClusterIP\" Web service type service.web.port int 8888 Web service port Used for the web interface listener service.web.appProtocol string \"http\" Web service appProtocol. Will be auto set to https if certificate is enabled. service.wireguard.annotations object {} Annotations for the WireGuard service service.wireguard.type string \"LoadBalancer\" Wireguard service type service.wireguard.ports list [51820] Wireguard service ports. Exposes the WireGuard ports for created interfaces. Lowerest port is selected as start port for the first interface. Increment next port by 1 for each additional interface. service.metrics.port int 8787 ingress.enabled bool false Specifies whether an ingress resource should be created ingress.className string \"\" Ingress class name ingress.annotations object {} Ingress annotations ingress.tls bool false Ingress TLS configuration. Enable certificate resource or add ingress annotation to create required secret certificate.enabled bool false Specifies whether a certificate resource should be created. If enabled, certificate will be used for the web. certificate.issuer.name string \"\" Certificate issuer name certificate.issuer.kind string \"\" Certificate issuer kind (ClusterIssuer or Issuer) certificate.issuer.group string \"cert-manager.io\" Certificate issuer group certificate.duration string \"\" Optional. Documentation certificate.renewBefore string \"\" Optional. Documentation certificate.commonName string \"\" Optional. Documentation certificate.emailAddresses list [] Optional. Documentation certificate.ipAddresses list [] Optional. Documentation certificate.keystores object {} Optional. Documentation certificate.privateKey object {} Optional. Documentation certificate.secretTemplate object {} Optional. Documentation certificate.subject object {} Optional. Documentation certificate.uris list [] Optional. Documentation certificate.usages list [] Optional. Documentation persistence.enabled bool false Specifies whether an persistent volume should be created persistence.annotations object {} Persistent Volume Claim annotations persistence.storageClass string \"\" Persistent Volume storage class. If undefined (the default) cluster's default provisioner will be used. persistence.accessMode string \"ReadWriteOnce\" Persistent Volume Access Mode persistence.size string \"1Gi\" Persistent Volume size persistence.volumeName string \"\" Persistent Volume Name (optional) serviceAccount.create bool true Specifies whether a service account should be created serviceAccount.annotations object {} Service account annotations serviceAccount.automount bool false Automatically mount a ServiceAccount's API credentials serviceAccount.name string \"\" The name of the service account to use. If not set and create is true, a name is generated using the fullname template monitoring.enabled bool false Enable Prometheus monitoring. monitoring.apiVersion string \"monitoring.coreos.com/v1\" API version of the Prometheus resource. Use azmonitoring.coreos.com/v1 for Azure Managed Prometheus. monitoring.kind string \"PodMonitor\" Kind of the Prometheus resource. Could be PodMonitor or ServiceMonitor. monitoring.labels object {} Resource labels. monitoring.annotations object {} Resource annotations. monitoring.interval string 1m Interval at which metrics should be scraped. If not specified config.statistics.data_collection_interval interval is used. monitoring.metricRelabelings list [] Relabelings to samples before ingestion. monitoring.relabelings list [] Relabelings to samples before scraping. monitoring.scrapeTimeout string \"\" Timeout after which the scrape is ended If not specified, the Prometheus global scrape interval is used. monitoring.jobLabel string \"\" The label to use to retrieve the job name from. monitoring.podTargetLabels object {} Transfers labels on the Kubernetes Pod onto the target. monitoring.dashboard.enabled bool false Enable Grafana dashboard. monitoring.dashboard.annotations object {} Annotations for the dashboard ConfigMap. monitoring.dashboard.labels object {} Additional labels for the dashboard ConfigMap. monitoring.dashboard.namespace string \"\" Dashboard ConfigMap namespace Overrides the namespace for the dashboard ConfigMap."},{"location":"documentation/getting-started/reverse-proxy/","title":"Reverse Proxy (HTTPS)","text":""},{"location":"documentation/getting-started/reverse-proxy/#reverse-proxy-for-https","title":"Reverse Proxy for HTTPS","text":"
For production deployments, always serve the WireGuard Portal over HTTPS. You have two options to secure your connection:
"},{"location":"documentation/getting-started/reverse-proxy/#reverse-proxy","title":"Reverse Proxy","text":"
Let a front\u2010end proxy handle HTTPS for you. This also frees you from managing certificates manually and is therefore the preferred option. You can use Nginx, Traefik, Caddy or any other proxy. 
 
Below is an example using a Docker Compose stack with Traefik.  It exposes the WireGuard Portal on https://wg.domain.com and redirects initial HTTP traffic to HTTPS.
 
services:\n  reverse-proxy:\n    image: traefik:v3.3\n    restart: unless-stopped\n    command:\n      #- '--log.level=DEBUG'\n      - '--providers.docker.endpoint=unix:///var/run/docker.sock'\n      - '--providers.docker.exposedbydefault=false'\n      - '--entrypoints.web.address=:80'\n      - '--entrypoints.websecure.address=:443'\n      - '--entrypoints.websecure.http3'\n      - '--certificatesresolvers.letsencryptresolver.acme.httpchallenge=true'\n      - '--certificatesresolvers.letsencryptresolver.acme.httpchallenge.entrypoint=web'\n      - '--certificatesresolvers.letsencryptresolver.acme.email=your.email@domain.com'\n      - '--certificatesresolvers.letsencryptresolver.acme.storage=/letsencrypt/acme.json'\n      #- '--certificatesresolvers.letsencryptresolver.acme.caserver=https://acme-staging-v02.api.letsencrypt.org/directory'  # just for testing\n    ports:\n      - 80:80 # for HTTP\n      - 443:443/tcp  # for HTTPS\n      - 443:443/udp  # for HTTP/3\n    volumes:\n      - acme-certs:/letsencrypt\n      - /var/run/docker.sock:/var/run/docker.sock:ro\n    labels:\n      - 'traefik.enable=true'\n      # HTTP Catchall for redirecting HTTP -> HTTPS\n      - 'traefik.http.routers.dashboard-catchall.rule=Host(`wg.domain.com`) && PathPrefix(`/`)'\n      - 'traefik.http.routers.dashboard-catchall.entrypoints=web'\n      - 'traefik.http.routers.dashboard-catchall.middlewares=redirect-to-https'\n      - 'traefik.http.middlewares.redirect-to-https.redirectscheme.scheme=https'\n\n  wg-portal:\n    image: wgportal/wg-portal:latest\n    container_name: wg-portal\n    restart: unless-stopped\n    logging:\n      options:\n        max-size: \"10m\"\n        max-file: \"3\"\n    cap_add:\n      - NET_ADMIN\n    ports:\n      # host port : container port\n      # WireGuard port, needs to match the port in wg-portal interface config (add one port mapping for each interface)\n      - \"51820:51820/udp\"\n      # Web UI port (only available on localhost, Traefik will handle the HTTPS)\n      - \"127.0.0.1:8888:8888/tcp\"\n    sysctls:\n      - net.ipv4.conf.all.src_valid_mark=1\n    volumes:\n      # host path : container path\n      - ./wg/data:/app/data\n      - ./wg/config:/app/config\n    labels:\n      - 'traefik.enable=true'\n      - 'traefik.http.routers.wgportal.rule=Host(`wg.domain.com`)'\n      - 'traefik.http.routers.wgportal.entrypoints=websecure'\n      - 'traefik.http.routers.wgportal.tls.certresolver=letsencryptresolver'\n      - 'traefik.http.routers.wgportal.service=wgportal'\n      - 'traefik.http.services.wgportal.loadbalancer.server.port=8888'\n\nvolumes:\n  acme-certs:\n
 
The WireGuard Portal configuration must be updated accordingly so that the correct external URL is set for the web interface:
 
web:\n  external_url: https://wg.domain.com\n
"},{"location":"documentation/getting-started/reverse-proxy/#built-in-tls","title":"Built-in TLS","text":"
If you prefer to let WireGuard Portal handle TLS itself, you can use the built-in TLS support. In your config.yaml, under the web section, point to your certificate and key files:
 
web:\n  cert_file: /path/to/your/fullchain.pem\n  key_file:  /path/to/your/privkey.pem\n
 
The web server will then use these files to serve HTTPS traffic directly instead of HTTP.
"},{"location":"documentation/getting-started/sources/","title":"Sources","text":"
To build the application from source files, use the Makefile provided in the repository.
"},{"location":"documentation/getting-started/sources/#requirements","title":"Requirements","text":"
     
  • Git
    •  
  • Make
    •  
  • Go: >=1.24.0
    •  
  • Node.js with npm: node>=18, npm>=9
    •  
"},{"location":"documentation/getting-started/sources/#build","title":"Build","text":"
# Get source code\ngit clone https://github.com/h44z/wg-portal -b ${WG_PORTAL_VERSION:-master} --depth 1\ncd wg-portal\n# Build the frontend\nmake frontend\n# Build the backend\nmake build\n
"},{"location":"documentation/getting-started/sources/#install","title":"Install","text":"
Compiled binary will be available in ./dist directory.  For installation instructions, check the Binaries section.
"},{"location":"documentation/monitoring/prometheus/","title":"Monitoring","text":"
By default, WG-Portal exposes Prometheus metrics on port 8787 if interface/peer statistic data collection is enabled.
"},{"location":"documentation/monitoring/prometheus/#exposed-metrics","title":"Exposed Metrics","text":"Metric Type Description wireguard_interface_received_bytes_total gauge Bytes received through the interface. wireguard_interface_sent_bytes_total gauge Bytes sent through the interface. wireguard_peer_last_handshake_seconds gauge Seconds from the last handshake with the peer. wireguard_peer_received_bytes_total gauge Bytes received from the peer. wireguard_peer_sent_bytes_total gauge Bytes sent to the peer. wireguard_peer_up gauge Peer connection state (boolean: 1/0)."},{"location":"documentation/monitoring/prometheus/#prometheus-config","title":"Prometheus Config","text":"
Add following scrape job to your Prometheus config file:
 
# prometheus.yaml\nscrape_configs:\n  - job_name: wg-portal\n    scrape_interval: 60s\n    static_configs:\n      - targets:\n          - localhost:8787 # Change localhost to IP Address or hostname with WG-Portal\n
"},{"location":"documentation/monitoring/prometheus/#grafana-dashboard","title":"Grafana Dashboard","text":"
You may import dashboard.json into your Grafana instance.
 
"},{"location":"documentation/rest-api/api-doc/","title":"REST API","text":""},{"location":"documentation/upgrade/v1/","title":"Upgrade","text":"
For production deployments of WireGuard Portal, we strongly recommend using version 1. If you want to use version 2, please be aware that it is still a release candidate and not yet fully stable.
"},{"location":"documentation/upgrade/v1/#upgrade-from-v1-to-v2","title":"Upgrade from v1 to v2","text":"
 Before upgrading from V1, make sure that you have a backup of your currently working configuration files and database!
 
To start the upgrade process, start the wg-portal binary with the -migrateFrom parameter. The configuration (config.yaml) for WireGuard Portal must be updated and valid before starting the upgrade.
 
To upgrade from a previous SQLite database, start wg-portal like:
 
./wg-portal-amd64 -migrateFrom=old_wg_portal.db\n
 
You can also specify the database type using the parameter -migrateFromType, supported types: mysql, mssql, postgres or sqlite. For example:
 
./wg-portal-amd64 -migrateFromType=mysql -migrateFrom='user:pass@tcp(1.2.3.4:3306)/dbname?charset=utf8mb4&parseTime=True&loc=Local'\n
 
The upgrade will transform the old, existing database and store the values in the new database specified in the config.yaml configuration file. Ensure that the new database does not contain any data!
 
If you are using Docker, you can adapt the docker-compose.yml file to start the upgrade process:
 
services:\n  wg-portal:\n    image: wgportal/wg-portal:latest\n    # ... other settings\n    restart: no\n    command: [\"-migrateFrom=/app/data/wg_portal.db\"]\n
"}]}
\ No newline at end of file
diff --git a/master/sitemap.xml b/master/sitemap.xml
index dde692f..503884f 100644
--- a/master/sitemap.xml
+++ b/master/sitemap.xml
@@ -28,6 +28,10 @@
          https://wgportal.org/master/documentation/getting-started/helm/
          2025-05-03
     
+    
+         https://wgportal.org/master/documentation/getting-started/reverse-proxy/
+         2025-05-03
+    
     
          https://wgportal.org/master/documentation/getting-started/sources/
          2025-05-03
diff --git a/master/sitemap.xml.gz b/master/sitemap.xml.gz
index 829536b8d3511a6cdca2f89aed6d67729e87035c..264ad55155ea126f683fff40262d44dc9dd61729 100644
GIT binary patch
delta 301
zcmV+|0n+}k0=xo{7=OWTgD?z+?|lly9ZWk-+9pbGeS+-)GVmZ8i6h4p_VzQSnx@{i
z3q*;MIF9}4mz9*K$@R$vIa>0^be|V#g1)B4`u3Q5+mZo(Qv5YpL-pX$ixCw8NY%Jl9M@#1$$!{(;AMxCaiPb!
z9ilC0)S`%1X%@w>U<2>g8@B7JbkC%xpX*lhJyD0f+Y%4s{P8F&zl#F1m5k3R#|H1)P!
zXp|_i