> For the complete documentation index, see [llms.txt](https://docs.lineverge.com/automail/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lineverge.com/automail/configurations/ui-configuration/admin.md).

# Admin

The admin page is accessible via \[site domain]**/admin**, or by clicking the admin item in the top right menu of the site.

## Authentication and Authorization

### Users

#### Create New User

{% hint style="info" %}
Users are saved in the database. This means a user created in PROD will not automatically exist in DEV and vice versa.
{% endhint %}

New users can be managed and created in the Users section.

![](https://lh5.googleusercontent.com/0jnqZeyDj23feQ1j0riszdRo6fH1v3WFxjPDqwyRFNySskJecieJbs-L2_hVffG5D8rCJ0hg-jBFjEZzZJ_v7cJoeTVgUggzBuu23glQ12-xgK-oal8bNygjM5ljSD3SkK1lPhkjx2olrE0WGLAXn7c)

To add a new user, click the **+ Add** button, then input a user name using the prefix of the user’s email address (e.g. <john_wayne@lineverge.com> => john\_wayne), and password *Temp12345*.

<figure><img src="https://lh3.googleusercontent.com/wbNMsFUnaP0qd10HVOaY0gbSKxGeaBT-Rj0tz2i-fHH1UcQEEbf0SMd43eJz-GNGCbBKioF_9ChAm_LoIHAbCppjJd4ZXEMRktbqwarZ3WKK-8D65mKInlnpXdRsL6Di852Z0AqL8XTeL-s12bKwM7s" alt=""><figcaption></figcaption></figure>

Click on **Save and continue editing**, add the Personal Info including email...

<figure><img src="/files/4OpOJjlyPo1aa4ZfCdIl" alt=""><figcaption></figcaption></figure>

... and assign the user to the right permissions group and click **SAVE**. [Florian Gamper](mailto:undefined)<mark style="background-color:orange;">TODO INTO 1 STEP WITHOUT MANUAL PASSWORD INPUT</mark>

{% hint style="info" %}
The password manually added when creating a new user will be overwritten with a randomly generated password when Automail sends the onboarding email to the users. This is only the case if the user has an email address defined in the Personal Info section.
{% endhint %}

Automail sends emails to the users through a backend process that needs to be scheduled and uses the below generic function that references the constants EMAIL\_USERNAME, EMAIL\_USERNAME\_SEND, EMAIL\_SIGNATURE, PROXIES, SUPPORT\_EMAIL\_ADDRESS, COMPANY\_NAME, APPLICATION\_NAME\_SHORT, ALLOWED\_HOSTS, and DEBUG settings.py.

```python
from _init import *
from polygon.apps.app_automail.functions import send_user_onboarding_email

if __name__ == "__main__":
    monitoring(
        send_user_onboarding_email,
        kwargs={"private_site": True, "log_file_path": log_file_path},
    )
```

#### Reset User Password

Click the **User onboarding emails** link.

![](/files/po9r9M8chB37LcnaaWgF)

Then select the target user(s) and click **Reset password(s)**, then **GO**.

![](/files/hmStrkIC7jbo6SYFg43o)

Automail will generate a new random password and send it to the user's registered email address.

#### Disable User

To make a user inactive, find the user under Users and uncheck the Active checkbox.

<figure><img src="https://lh5.googleusercontent.com/9ura0YyibdKB-srR8_niaHId9d4BSfVO24CH94X04lmRDsE2uZl9a2aF_gXyD_ir7WpTFAxWnSovmWucAEAXD5ye8oggtXN95SoUUBYZmd_vcPbKYk6Y5euIncysURuygu5wIbveQVonGPutiYLmrVE" alt=""><figcaption></figcaption></figure>

### Groups

{% hint style="info" %}
The idea of groups is to be used in allowed\_user\_groups ists in **urls.py**.
{% endhint %}

Groups are defined in the **Groups** section.

![](/files/O2NsOH70WTg7NxCUZlp9)

Once a group is defined, it can be assigned to a user in the **User** section by selecting a user.

<figure><img src="/files/D8onnIJ4kBeZPrR14o4w" alt=""><figcaption></figcaption></figure>
