TrueNAS Open Storage Logo
TrueNAS.com Products Enterprise Support Community Support Truenas Security Get TrueNAS Enterprise Download TrueNAS Community Edition About TrueNAS Careers
TrueNAS Open Storage Logo
F-Series
F-Series

All-Flash NVMe Performance.

H-Series
H-Series

Big business performance. Entry level pricing.

Mini Series
Mini Series

Home Labs, Small Office & SMB Applications.

M-Series
M-Series

All-Flash or Hybrid Enterprise Performance.

R-Series
R-Series

Single Controller Storage Appliances.

TrueNAS Enterprise Icon
TrueNAS Enterprise

Mission Critical Storage. 24×7 Enterprise Support.

TrueCommand Icon
TrueCommand

Manage Your TrueNAS Fleet All From One Place.

Use Cases

Analytics Backup & Archival Cloud Data Mobility File Sharing
iX-Storj Media & Entertainment Surveillance Veeam Backup Virtualization

Industry

Audio Broadcasting Gaming Healthcare Manufacturing Media & Entertainment
Automotive Education Government MSP Research & AI

Support

Enterprise Support

For customers with active support contracts.

Community Support

For peer-to-peer, open-source support.

Resources

Case Studies Documentation Apps TrueNAS Security FAQ ZFS Overview
TrueNAS Blog Solution Guides Datasheets Software Status Videos TrueCommand Cloud
TrueNAS Community Edition Community Forum Discord TrueNAS GitHub TrueNAS Merch Store
About TrueNAS Awards Careers Contact Us Our Clients Reviews
Contact Icon
Contact an Enterprise Specialist

Speak with an enterprise storage specialist to find the right solutions for your business needs.

TrueNAS Enterprise Icon
TrueNAS Enterprise

Enterprise-grade storage appliances designed for business and mission-critical environments.

TrueNAS Community Edition Icon
Download TrueNAS Community Edition

Test Drive TrueNAS in Your Environment.

  1. TrueNAS 25.04 (Early)
  2. /
  3. TrueNAS Tutorials
  4. /
  5. Credentials
  6. /
  7. Setting Up Directory Services
  8. /
  9. Configuring LDAP
Edit page
TrueNAS TrueNAS Stable Version Documentation
This content follows TrueNAS 25.04 (Fangtooth) releases.
Use the Product and Version selectors above to view content specific to a different software release.

Configuring LDAP

  2 minute read.

TrueNAS has an Open LDAP client for accessing the information on an LDAP server. An LDAP server provides directory services for finding network resources like users and their associated permissions.

You can have either Active Directory or LDAP configured on TrueNAS but not both.

Configuring LDAP

To configure TrueNAS to use an LDAP directory server:

  1. Go to Credentials > Directory Services and click Configure LDAP.

    LDAPBasicOptionsSettings

  2. Enter your LDAP server host name. If using a cloud service LDAP server, do not include the full URL.

  3. Enter your LDAP server base DN. This is the top of the top level of the LDAP directory tree to use when searching for resources.

  4. Enter the bind DN (administrative account name for the LDAP server) and the bind password.

  5. Select Enable to activate the server

  6. Click Save.

If you want to further modify the LDAP configuration, click Advanced Options. See the LDAP UI Reference article for details about advanced settings.

When using the idmap_ad backend, TrueNAS relies on the LDAP server to provide uidNumber and gidNumber attributes for users and groups. If users are missing a uidNumber, they might appear in queries (wbinfo -u) but fail when a UID is required. Ensure the LDAP directory assigns uidNumber values to all users. If users do not map correctly, check the LDAP server settings and verify attribute assignments.
The Legacy Samba Schema, needed to populate the LDAP directory with Samba attributes, was deprecated in TrueNAS 22.10 and removed in 24.10. SMB shares can no longer be set up using LDAP authentication.

Disabling LDAP

To disable LDAP but not remove the configuration, clear the Enable checkbox. The main Directory Services screen returns to the default view showing the options to configure Active Directory or LDAP. To enable LDAP again, click Configure LDAP to open the LDAP screen with your saved configuration. Select Enable again to reactivate your LDAP directory server configuration.

Removing LDAP from TrueNAS

To remove the LDAP configuration, click Settings to open the LDAP screen. Clear all settings and click Save.

Related Content

Tutorials
UI Reference

Have more questions?

For further discussion or assistance, see these resources:

Found content that needs an update?  You can suggest content changes directly! To request changes to this content, click the Feedback button located on the middle-right side of the page (might require disabling ad blocking plugins).