iartamonov/matrix-docker-ansible-deploy
1
0
Fork 0
mirror of https://github.com/spantaleev/matrix-docker-ansible-deploy.git synced 2026-04-15 18:15:25 +03:00
Code Issues Packages Projects Releases Wiki Activity

Slightly clarify Traefik Dashboard instructions

Browse Source 
Updated instructions for enabling the Traefik Dashboard, including username and password generation for basic authentication.
This commit is contained in:
QEDeD
2026-04-15 09:32:32 +02:00
committed by Slavi Pantaleev
parent 05f10831cc
commit 642427a6db
1 changed files with 14 additions and 2 deletions
Download Patch File Download Diff File Expand all files Collapse all files

16
docs/configuring-playbook-traefik.md
View File

@@ -25,7 +25,7 @@ traefik_config_accessLog_enabled: false
### Enable Traefik Dashboard ### Enable Traefik Dashboard
To enable a Traefik [Dashboard](https://doc.traefik.io/traefik/operations/dashboard/) UI at `https://matrix.example.com/dashboard/` (note the trailing `/`), add the following configuration to your `vars.yml` file: To enable the Traefik [Dashboard](https://doc.traefik.io/traefik/operations/dashboard/) UI at `https://matrix.example.com/dashboard/` (note the trailing `/`), add the following configuration to your `vars.yml` file:
```yaml ```yaml
traefik_dashboard_enabled: true traefik_dashboard_enabled: true
@@ -34,7 +34,19 @@ traefik_dashboard_basicauth_enabled: true
traefik_dashboard_basicauth_htpasswd: "YOUR_USERNAME_HERE:$apr1$..." traefik_dashboard_basicauth_htpasswd: "YOUR_USERNAME_HERE:$apr1$..."
``` ```
Generate the `traefik_dashboard_basicauth_htpasswd` value on your local machine with a command like `htpasswd -nb YOUR_USERNAME_HERE YOUR_PASSWORD_HERE`. Choose a username and password for the dashboard, then generate the corresponding `htpasswd` entry with:
```sh
htpasswd -nb YOUR_USERNAME_HERE YOUR_PASSWORD_HERE
```
The command outputs the exact value to use for `traefik_dashboard_basicauth_htpasswd` — your username, a colon, and a hash of your chosen password:
```text
YOUR_USERNAME_HERE:$apr1$...
```
Copy the full output line into `traefik_dashboard_basicauth_htpasswd`. After deploying, log in to the dashboard using the same username and password that you chose earlier.
The role also supports the legacy `traefik_dashboard_basicauth_user` / `traefik_dashboard_basicauth_password` convenience variables, but that path depends on the `passlib` Python library on the Ansible controller, may be affected by passlib/bcrypt compatibility issues, and generates non-deterministic hashes which can lead to unnecessary changes. The role also supports the legacy `traefik_dashboard_basicauth_user` / `traefik_dashboard_basicauth_password` convenience variables, but that path depends on the `passlib` Python library on the Ansible controller, may be affected by passlib/bcrypt compatibility issues, and generates non-deterministic hashes which can lead to unnecessary changes.