LDAP Active Directory and BookStack in Docker #353

New Issue

OVERLORD · 2026-02-04T18:58:02+03:00

OVERLORD commented

2026-02-04 18:58:02 +03:00

Originally created by @mry on GitHub (Jun 10, 2017).

Specific to running BookStack inside a Docker container and populating the environment variables.

For Feature Requests

Update documentation to either include a clarifying note or include setting in example.

#use double $$ since we are using docker
- LDAP_USER_FILTER=(&(sAMAccountName=$${user}))

Expected Behavior

The PHP variable is expanded within BookStack and the LDAP query matches as expected.

Actual Behavior

With the single $ sign, the expression becomes a static string and the query will never return a result and no error message is thrown. Can be verified by replacing with a proper username.

Originally created by @mry on GitHub (Jun 10, 2017). Specific to running BookStack inside a Docker container and populating the environment variables. ### For Feature Requests Update documentation to either include a clarifying note or include setting in example. #use double $$ since we are using docker - LDAP_USER_FILTER=(&(sAMAccountName=$${user})) ##### Expected Behavior The PHP variable is expanded within BookStack and the LDAP query matches as expected. ##### Actual Behavior With the single $ sign, the expression becomes a static string and the query will never return a result and no error message is thrown. Can be verified by replacing with a proper username.

OVERLORD added the 🛠️ Enhancement 📖 Docs Update labels 2026-02-04 18:58:02 +03:00

OVERLORD closed this issue

2026-02-04 18:58:07 +03:00

OVERLORD commented

2026-02-04 18:58:16 +03:00

@PipeItToDevNull commented on GitHub (Sep 28, 2018):

Just a note. I had to map my .env file as a volume, and then manually edit this field to "LDAP_USER_FILTER=(&(sAMAccountName={user}))". Even with this $ trick that I found elsewhere it seems like the file was written with strange characters or just no $'s at all.

@PipeItToDevNull commented on GitHub (Sep 28, 2018): Just a note. I had to map my .env file as a volume, and then manually edit this field to "LDAP_USER_FILTER=(&(sAMAccountName=${user}))". Even with this $$ trick that I found elsewhere it seems like the file was written with strange characters or just no $'s at all.

OVERLORD commented

2026-02-04 18:58:22 +03:00

@ssddanbrown commented on GitHub (Feb 6, 2021):

Thanks for the suggestion @mry.

A note has since been added for this option in the documentation.

@ssddanbrown commented on GitHub (Feb 6, 2021): Thanks for the suggestion @mry. A note has since been added for this option in the documentation.

Sign in to join this conversation.

Branches Tags

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: starred/BookStack#353