> ## Documentation Index
> Fetch the complete documentation index at: https://ayakaleaf-pro.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# Onboarding

> Create the first administrator, check your instance and add the first user.

Do this once, right after the [installation](https://ayakaleaf-pro.mintlify.site/on-premises/installation/introduction.md). This page uses the default password login.

**1. Open the launchpad**

Open `/launchpad` on your instance, for example `http://localhost/launchpad`. You see **Create the first Admin account**.

The form is there only until the first administrator exists. After that, signed-out visitors are sent to the login page.

**2. Create the administrator account**

Enter an email and a password, then click **Register**.

![The launchpad form filled in with admin@example.com](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/onboarding-launchpad-filled.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=44fc484a4761ab3d6290d0555d01cc5f)

The first administrator account

If the password is refused, a message appears above the form and no account is created.

![The message password is too short above the launchpad form](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/onboarding-password-error.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=5808d2137a1291f81ab19c4a1b2fc7aa)

A refused password

| Message | Meaning |
| - | - |
| `password is too short` | Fewer than 8 characters. |
| `password is too long` | More than 72 characters. |
| `password contains an invalid character` | Allowed are letters `a-z` and `A-Z`, digits and `@#$%^&*()-_=+[]{};:<>/?!£€.,`. Spaces and accented or non-Latin letters are not. |
| `password contains part of email address` | It contains the email or the part before `@`, or it is part of the email. For `admin@example.com`, both `admin-7Tq9-demo` and `example.com` are refused. |
| `password is too similar to email address` | It is close to the email, for example `adm1n@example.c0m`. |

Capital letters, digits and symbols are not required by default. To change the length limits, see [Password restrictions](https://ayakaleaf-pro.mintlify.site/on-premises/configuration/overleaf-toolkit/authentication/password-restrictions.md).

**3. Log in**

After **Register** you are on the login page. Enter the same email and password, then click **Login**.

![The login page filled in with admin@example.com](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/onboarding-login.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=98d690d531f3c9ae4c2d4fb30e6f485c)

Log in with the new account

You are back on the launchpad, now with **Status Checks**.

**4. Check the instance**

`websockets` should show **OK**.

To test email, enter your address under **Send a test email**, click **Send**, then check your inbox.

![The launchpad with websockets OK, the test email form showing Email Sent, and the two buttons at the bottom](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/onboarding-launchpad-checks.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=2a82fa143112596c74c478ad3169366f)

Status checks and the test email

> [!WARNING]
>
> **Email Sent** does not prove that a message left the server. Without [email delivery](https://ayakaleaf-pro.mintlify.site/on-premises/configuration/overleaf-toolkit/email-delivery.md), the page shows the same text and nothing arrives.

**Start Using** *your site name* opens your projects. **Go To Admin Panel** opens the site tools, see [Basic management](https://ayakaleaf-pro.mintlify.site/on-premises/user-guide/administrators/basic-management.md).

**5. Create the first user**

In the top menu, click **Admin**, then **Manage Users**.

![The Admin menu with Manage Site, Manage Users and Project/Object Lookup](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/onboarding-admin-menu.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=56643626dfb1dfa5034462cff38e5970)

The Admin menu

Click **Create account**.

![The user list with the administrator and the Create account button](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/onboarding-user-list.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=fa3a7b2ecfc0e436e1cd0e825054eaa9)

The user list

Enter the user's email. **First name** and **Last name** are optional. Tick **Admin** only for another administrator. Click **Create**.

![The Create account dialog filled in with user@example.com](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/onboarding-create-account.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=062b5fce0a96597e2cee442ba4aeffa8)

The Create account dialog

The account appears in the list with the status **Pending**.

![The user list with Demo User in the Pending status](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/onboarding-user-pending.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=af6cfa1df17e2105c2a8dd079dad6b8c)

A new account stays Pending until its first login

**6. Give the user access**

**With email delivery configured**, the user receives an activation email with a **Set password** link. The link opens this page. The user enters a password and clicks **Activate**, and then lands on the projects page. The password rules above apply.

![The activation page asking the user to set a password](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/onboarding-activate.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=6db5a3f0fcafc3cc35759a049e4eaa72)

What the user sees after opening the link

**Without email delivery**, pass the link on yourself. In **Manage Users**, click the envelope icon on the user's row, then **Send activation email**. The dialog says **No email was sent** and shows the link, which expires in 7 days. Click the copy icon and send the link to the user, who sets a password as above.

![The Send activation email dialog for Demo User with the warning that no email was sent, the link, a copy icon and Expires in 7 days](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/onboarding-activation-link.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=9e92753fb01774d491f0887c2bcad139)

The activation link to pass on

You can also set a password yourself. In **Manage Users**, click the user's name, then the pencil icon. Enter **New password** and click **Save**. Pass the password on to the user, who logs in at `/login`.

![The Account tab of a user in edit mode with the New password field filled in](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/onboarding-set-password.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=1646b633c88bad8c37c0f3ca48349eea)

Setting a password on the Account tab

**7. Confirm it worked**

After the user's first login, the status in **Manage Users** changes to **Active**.

![The user list with Demo User in the Active status](https://mintcdn.com/ayakaleaf-pro/PeD9iteXIf8j4GXw/images/on-premises/onboarding-user-active.png?fit=max\&auto=format\&n=PeD9iteXIf8j4GXw\&q=85\&s=83bc92f638b2a5aa46be1d32bd5ece81)

The user has logged in

> [!NOTE]
>
> **Sign up** does not create accounts by default: the page asks visitors to contact the address in `OVERLEAF_ADMIN_EMAIL`. To let people register themselves, see [Public Access](https://ayakaleaf-pro.mintlify.site/on-premises/configuration/overleaf-toolkit/authentication/public-access.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.