> ## Documentation Index
> Fetch the complete documentation index at: https://docs.usedatabrain.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Invite Users?

> Learn how to invite users and configure email settings in both app and self-hosted environments.

## App Environment

### 1. Inviting a User

In the app environment, an admin can invite users with or without configuring email settings.\
In both cases, the invited user will receive an email notification with a secure login link.

* **If email settings are configured:**\
  The invitation email will be sent using your configured email service.
* **If email settings are not configured:**\
  Databrain will automatically send the invitation email.

<Steps>
  <Step title="Invite a User">
    1. Navigate to the **"Invite User"** section.
    2. Enter the user’s email address.
    3. Assign a role — Developer, Editor, or Viewer and select the workspaces the user should have access to.
    4. Click **"Invite"** to complete the process.
  </Step>
</Steps>

<Frame caption="Inviting a User in the App Environment">
  <img src="https://mintcdn.com/databrainlabs-bef6850a/IOxmGGEe0Fs9FxND/InviteUserFlow(1).gif?s=bcc9d050e0992bb74b4c7e479c1b01c8" alt="Databrain Invite User interface showing user roles and workspace access" title="" style={{ width:"100%" }} width="1627" height="921" data-path="InviteUserFlow(1).gif" />
</Frame>

***

### 2. Logging In

The invited user will receive an email containing a login link.\
By clicking the link, they can log in and access their Databrain account.

<Frame caption="User login interface after invitation">
  <img src="https://mintcdn.com/databrainlabs-bef6850a/IOxmGGEe0Fs9FxND/UserLogin.gif?s=13f2d3cd0868d2f098f5ae0348d8038a" alt="Databrain login interface for invited user" width="1486" height="702" data-path="UserLogin.gif" />
</Frame>

***

## Self-Hosted Environment

In a self-hosted environment, the admin must configure email settings before inviting users.\
This ensures that invitation emails are delivered successfully.

### 1. Configuring Email Settings

<Steps>
  <Step title="Configure Email Settings">
    1. Navigate to the **"Settings"** page.
    2. In the **"Embed Settings"** section, configure the required email settings.
    3. Click **"Authenticate"** to save and validate the configuration.
  </Step>
</Steps>

<Frame caption="Email Settings configuration in self-hosted Databrain environment">
  <img src="https://mintcdn.com/databrainlabs-bef6850a/IOxmGGEe0Fs9FxND/Configureemailsettings(1).png?fit=max&auto=format&n=IOxmGGEe0Fs9FxND&q=85&s=471a7ac118d5aa34b84e6528426faf72" alt="Databrain Email Settings configuration page" width="2934" height="1652" data-path="Configureemailsettings(1).png" />
</Frame>

***

### 2. Inviting a User

After the email settings are configured:

<Steps>
  <Step title="Invite a User">
    1. Navigate to the **"Invite User"** section.
    2. Enter the user’s email address.
    3. Assign a role — Developer, Editor, or Viewer and select the workspaces the user should have access to.
    4. Click **"Invite"** to complete the process.
  </Step>
</Steps>

<Frame caption="Inviting a User in the Self-Hosted Environment">
  <img src="https://mintcdn.com/databrainlabs-bef6850a/IOxmGGEe0Fs9FxND/InviteUserFlow.gif?s=ff3b2fe51766b03614869b7831716c56" alt="Databrain Invite User form after configuring email settings" width="1627" height="921" data-path="InviteUserFlow.gif" />
</Frame>

***

### 3. Logging In

The invited user will receive an email containing the login link.\
They can click the link and log in to access their Databrain account.

<Frame caption="User login screen for invited user">
  <img src="https://mintcdn.com/databrainlabs-bef6850a/IOxmGGEe0Fs9FxND/UserLogin.gif?s=13f2d3cd0868d2f098f5ae0348d8038a" alt="Databrain Accept Invitation login page" width="1486" height="702" data-path="UserLogin.gif" />
</Frame>