This topic is under construction for the 17.3 release of LabKey Server. For current documentation of this feature, click here.
Once you've set up LabKey Server, you're ready to start adding new users. There are multiple ways to add new users to your LabKey installation.
Users Authenticated by LDAP and Single Sign On
If your LabKey Server installation has been configured to authenticate users with an LDAP server
or CAS single sign on
, you don't need to explicitly add user accounts to LabKey Server.
Every user recognized by the LDAP or single sign on servers can log into LabKey using their user name and password. If they are not already a member, any user who logs in will automatically be added to the "Site Users" group, which includes all users who have accounts on the LabKey site.
Users Authenticated by LabKey
If you are not using LDAP or single sign on authentication, then you must explicitly add each new user to the site.
If you are a site administrator, you can add new users to the LabKey site by entering their email addresses on the Site Users
- Select (Admin) > Site > Site Users.
- Click Add Users.
- Enter one or more email addresses.
- Clone permissions from an existing user if appropriate, otherwise individually assign permissions next.
- Click Done.
If you have administrative privileges on a project or folder, you can add new users to the LabKey site by adding them to a group in that project. Any users added in this way will also be added to the global "Site Users" group if they are not already included there.
If you are not a site administrator but you have administrative privileges on a project, you can add a new user on the permissions page of any project. The user will simultaneously be added to the "Site Users" group.
- Select (Admin) > Folder > Permissions.
- Click the Project Groups tab.
- Create a new project group or add the user's email address to an existing group.
- Return to the Permissions tab to define the security roles for that group if needed.
- Click Save and Finish when finished.
When an administrator adds a new user, that user will receive an email containing a link to a LabKey page where they can log into the system. If you are not using LDAP, the new user will be prompted to choose their own password and log in with that password. The user's password is stored in the database in an encrypted format.
Note: If you have not configured an email server for LabKey Server to use to send system emails, you can still add users to the site, but they won't receive an email from the system. You'll see an error indicating that the email could not be sent that includes a link to an HTML version of the email that the system attempted to send. You can copy and send this text to the user directly if you would like them to be able to log into the system.