Installation
Download
Download the module from the DoliStore or from your CAP-REL customer area.
Installing the module
-
Unzip the downloaded archive
-
Copy the
smartauthfolder into thehtdocs/custom/directory of your Dolibarr installation -
Install the Composer dependencies:
cd htdocs/custom/smartauth composer install --no-dev
Activation
- Log in as a Dolibarr administrator
- Go to Home > Setup > Modules/Applications
- Search for "Smartauth" in the module list
- Click the activation button

The module automatically creates the required database tables upon activation.
Verification
After activation, the Tools > SmartAuth menu appears in the left sidebar. You land on the module's dashboard.
Accessing the configuration
Go to Home > Setup > Modules > SmartAuth to access the different configuration tabs:
- Settings -- General configuration (token lifetime, default user, logs, debug)
- OAuth server -- Activation and configuration of the OAuth2/OIDC server
- GeoIP -- Download and activation of the GeoIP database for geolocation
- About -- Module information and version
Permissions
The module defines a read permission. Assign it to the users who need to access SmartAuth features:
- Go to Home > Users & Groups
- Open the record of the relevant user
- In the Permissions tab, enable the "Read objects of SmartAuth" permission
Warning: Only Dolibarr administrators have access to the module's configuration pages.
Public SSO portal (optional)
If you enable the OAuth2/OIDC server, it is strongly recommended to expose the public SSO portal (htdocs/custom/smartauth/public/) on a dedicated subdomain (example: https://auth.example.com). This portal serves the login page, registration, password reset and the OIDC endpoints (/.well-known/openid-configuration, /.well-known/jwks.json, /oauth/*).
See the Public SSO portal section of the OAuth2/OIDC chapter for the complete Apache vhost configuration, the /.well-known/ exception to add, and the Dolibarr constants to define (SMARTAUTH_APP_URL, SMARTAUTH_REGISTRATION_ENABLED, SMARTAUTH_ACCOUNT_ENABLED).