Skip to content

docs: add config.example.yml; slim default config.yml to htpasswd#318

Open
allamiro wants to merge 1 commit into
lixmal:masterfrom
allamiro:upstream/feat-config-example-file
Open

docs: add config.example.yml; slim default config.yml to htpasswd#318
allamiro wants to merge 1 commit into
lixmal:masterfrom
allamiro:upstream/feat-config-example-file

Conversation

@allamiro

Copy link
Copy Markdown
Contributor

Fixes #317

Summary

  • config.example.yml (new) — copy-and-edit reference showing all backends with realistic, testable values:

    • LDAP section pre-filled from the docker-compose OpenLDAP test service (ldap://openldap:1389, ou=users,dc=example,dc=org, admin credentials matching .env.example)
    • OIDC section pre-filled from tests/keycloak/realm.json and .env.example (http://keycloak:8080/realms/keepass, client keepass4web, secret insecure-example-client-secret)
    • All options documented inline, including cookie_samesite: lax caveat for OIDC
  • config.yml — stripped to a minimal htpasswd configuration. LDAP and OIDC sections removed. Header comment points users to config.example.yml for other backends.

Effect

Users enabling a docker-compose auth service now have a one-stop reference: copy the matching section from config.example.yml into config.yml and it works immediately.

config.example.yml is a copy-and-edit reference showing all backends with
realistic, testable values:
- LDAP section pre-filled with the docker-compose OpenLDAP test values
  (uri, base_dn, bind, filter match .env.example exactly)
- OIDC section pre-filled with the Keycloak test values (issuer, client_id,
  client_secret match tests/keycloak/realm.json and .env.example)
- All options documented inline with context and caveats

config.yml is now a minimal htpasswd configuration. LDAP and OIDC sections
are removed; a header comment points to config.example.yml for other
backends. The file works out of the box once a .htpasswd file is created.

Fixes lixmal#317
@allamiro allamiro force-pushed the upstream/feat-config-example-file branch from 47730e5 to 36b49b3 Compare June 13, 2026 12:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

docs: add config.example.yml with LDAP and OIDC examples; slim down default config.yml

1 participant