# First Login · Getting Started

Sign in with the initial administrator account, change its credentials and configure the first agent account.

Canonical: https://docs.mintsd.com/docs/mint-service-desk/getting-started-first-login
Language: en-GB
Revision: 2a2d39f1e31deba465d9905cd685a5a3416966a588eb6151bba19ba5bc3c7cc9

<a id="element-01a1452d-eb58-7f8d-a9a1-2cf64e644ea7"></a>

## Administrator sign-in

Type your server IP or domain address on your web browser and login with the default admin
account credentials (remember to change it):

<a id="element-01a1452d-eb59-79d8-8b9b-203c5abdc80e"></a>

Login: **admin** Password: **admin1**

<a id="element-01a1452d-eb5a-722e-9bdc-bdd8e04a1301"></a>

![First Login: Login: admin Password: admin1](https://docs.mintsd.com/api/reader/assets/assets/images/image2.JPG?v=ee66072d0174268462f37da912abc8798af1f1601d468f1c98e79277efa9e38f)

<a id="element-01a1452d-eb5b-78d7-b291-d75fe4dd91cc"></a>

## Initial configuration

Complete the following configuration before using Mint Service Desk:

<a id="element-01a1452d-eb5c-7634-b302-a5e327ade32c"></a>

<a id="element-01a1452d-eb5d-75df-ba65-af15d917cbca"></a>

1. Define a new email account from which messages will be sent. You can
   do it in section Email > Accounts. Right here you need to click on
   the small ![Add](https://docs.mintsd.com/api/reader/assets/assets/images/image3.png?v=50654a0321a77a3b2271140f1b6a5080d18fbef92f3639b9b83ad57f0fd5735d#element-01a1452d-eb5c-7634-b302-a5e327ade32c) button located on the right side of the search
   bar.

<a id="element-01a1452d-eb5d-799e-b984-1065cac2fe8e"></a>

![First Login: Define a new email account from which messages will be sent. You can do it in section Email > Accounts. Right here you need to click on the small button located on the right side of the search bar.](https://docs.mintsd.com/api/reader/assets/assets/images/image4.jpeg?v=4736e8679b4206817d9bff7659deeb1e0468e070679a8b5cc02943a443e3501a)

<a id="element-01a1452d-eb5f-724f-9a5f-4caa26832cb7"></a>

> In “Create Account”, complete the required fields marked with an asterisk \*. You can add further information in “Description”.

<a id="element-01a1452d-eb60-7e5b-bf1a-7671bbe182f7"></a>

![First Login: Inside the “Create Account” view you will need to fill up the required information (fields marked with a *). Also, you can add some additional information inside the “Description” text field.](https://docs.mintsd.com/api/reader/assets/assets/images/image463.png?v=c73438774e31e2c24152f6faaeaced172f5125bfa6a4eab82d6ced1275eb6a9f)

<a id="element-01a1452d-eb65-7c72-b9d7-62b06f4c016b"></a>

> Select the email service:
>
> - Gmail
> - Yahoo!
> - Microsoft Office 365
> - Other
> - Microsoft Graph Api
>
> Enter the required settings. See **Admin > Email > Accounts** for account configuration details.

<a id="element-01a1452d-eb66-7162-860f-adaae4f7fdfb"></a>

![First Login: Now, in the next view, you will need to select which email you’re using. You can choose: Gmail Yahoo! Microsoft Office 365 Other Microsoft Graph Api After that fill up the necessary information – you will find more information about creating accounts in the Admin>Email>Accounts part of this guide.](https://docs.mintsd.com/api/reader/assets/assets/images/image466.png?v=5ff052719a2e2bca7af50e1a1d861bc60432b505b04f199ea5577a6d9fe94eaa)

<a id="element-01a1452d-eb67-7289-9676-d8d3aaaca7a9"></a>

<a id="element-01a1452d-eb6a-7ed8-8b84-62cbdf160387"></a>

> Once you finish, click on the ![Save](https://docs.mintsd.com/api/reader/assets/assets/images/image8.png?v=c6dfcae62b1da5a56376cb98f40e0a593d8d731e458977d27180f6380454b49d#element-01a1452d-eb67-7289-9676-d8d3aaaca7a9) button to finish the process and
> save the new email account.
>
> You will be moved to the list of existing accounts, where you will see a
> new position with some information about your new email account.

<a id="element-01a1452d-eb6b-77fe-ad77-0b2378def9c6"></a>

<a id="element-01a1452d-eb6c-7dbd-b29c-d781ef39519e"></a>

1. Define at least one “Body” type template component which includes at
   least ‘{{EmailURL}}’.

   You can do it in section Tickets > Components.

   Right here you need to click on the small ![Add](https://docs.mintsd.com/api/reader/assets/assets/images/image3.png?v=50654a0321a77a3b2271140f1b6a5080d18fbef92f3639b9b83ad57f0fd5735d#element-01a1452d-eb6b-77fe-ad77-0b2378def9c6) button located on
   the right side of the search bar.

<a id="element-01a1452d-eb6d-7c9f-a40f-f07093faf8a4"></a>

![First Login: Define at least one “Body” type template component which includes at least ‘{{EmailURL}}’. You can do it in section Tickets > Components. Right here you need to click on the small button located on the right side of the search bar.](https://docs.mintsd.com/api/reader/assets/assets/images/image9.jpeg?v=9e091bb40c16065aaac30524c3e4261ae0f01c3cc5b8af0c1b99c8595089e950)

<a id="element-01a1452d-eb6d-73ad-bf1a-64f8178badfe"></a>

<a id="element-01a1452d-eb6e-7972-b717-290ebc82885c"></a>

> In the view responsible for creating a new template component click
> on the ![Cut](https://docs.mintsd.com/api/reader/assets/assets/images/image10.png?v=6631d54647f75a6aba267625c2e924264b9c580b3292cad6492c2bcc93e9c1bf#element-01a1452d-eb6d-73ad-bf1a-64f8178badfe) button located right below the ‘Description’ section.
> Select Email > Url from the menu.

<a id="element-01a1452d-eb6e-7ef8-b5e3-ef875b0b5b7b"></a>

![First Login: In the view responsible for creating a new template component click on the button located right below the ‘Description’ section. Select Email > Url from the menu.](https://docs.mintsd.com/api/reader/assets/assets/images/image11.png?v=285ba97e22b5aed3d726a94e0740c4e9379b9c1df5026ee6601386f059e963ec)

<a id="element-01a1452d-eb6f-7331-9d26-3945cb28752b"></a>

![First Login: In the view responsible for creating a new template component click on the button located right below the ‘Description’ section. Select Email > Url from the menu.](https://docs.mintsd.com/api/reader/assets/assets/images/image12.png?v=0fe41fa78c98aab7b8a437047022e616bd3ebdc9552dbb523036f6857030beb0)

<a id="element-01a1452d-eb70-7eb1-88b6-349bcd0fadc0"></a>

<a id="element-01a1452d-eb71-7d21-854f-978f81264279"></a>

> Now click on the ![Save](https://docs.mintsd.com/api/reader/assets/assets/images/image8.png?v=c6dfcae62b1da5a56376cb98f40e0a593d8d731e458977d27180f6380454b49d#element-01a1452d-eb70-7eb1-88b6-349bcd0fadc0) button.
>
> You will find detailed description regarding creating templates in the
> Admin>Tickets>Templates part of this guide.

<a id="element-01a1452d-eb71-70e6-8e6d-c9fa83ec1b87"></a>

<a id="element-01a1452d-eb72-7b1c-ac7e-90c431da25cf"></a>

3. Define at least one template. You can do it in Tickets > Templates
   section.

   Right here you need to click on the small ![Add](https://docs.mintsd.com/api/reader/assets/assets/images/image3.png?v=50654a0321a77a3b2271140f1b6a5080d18fbef92f3639b9b83ad57f0fd5735d#element-01a1452d-eb71-70e6-8e6d-c9fa83ec1b87) button located on the
   right side of the search bar.

<a id="element-01a1452d-eb72-701b-b84e-4c864fe07adc"></a>

![First Login: Define at least one template. You can do it in Tickets > Templates section. Right here you need to click on the small button located on the right side of the search bar.](https://docs.mintsd.com/api/reader/assets/assets/images/image14.jpeg?v=880e9bdf702c9536683fbbc0c063ecc4ac7cfebefe6f7d33e861d0e471f965d7)

<a id="element-01a1452d-eb73-7880-b5ef-39c8556939be"></a>

> Select the previously created Body component in “Select body”. Enter a template name and choose “system” under “Template type”.

<a id="element-01a1452d-eb74-71f3-b178-d965718e93a7"></a>

![First Login: Select the previously created Body component in “Select body”. Enter a template name and choose “system” under “Template type”.](https://docs.mintsd.com/api/reader/assets/assets/images/image15.jpeg?v=d09c2c291072d623e97b3e853b09713a8610dab79211c7fb3f8427f81ef6299a)

<a id="element-01a1452d-eb75-7ec9-95f8-2bc80206bd42"></a>

<a id="element-01a1452d-eb76-7894-add5-8656ee37853f"></a>

> Click on the ![Save](https://docs.mintsd.com/api/reader/assets/assets/images/image8.png?v=c6dfcae62b1da5a56376cb98f40e0a593d8d731e458977d27180f6380454b49d#element-01a1452d-eb75-7ec9-95f8-2bc80206bd42) button.

<a id="element-01a1452d-eb77-78c2-afba-d5e01598512f"></a>

4. In Settings > General > Templates, select the template you created under “Email confirmation template”.

<a id="element-01a1452d-eb78-70aa-9455-7cb756abc70b"></a>

![First Login: Now you need to Set up ‘Email confirmation Template’. You can do it in the Settings>General>Templates and choosing already created template from the list in the ‘Email confirmation template’ section.](https://docs.mintsd.com/api/reader/assets/assets/images/image16.png?v=5827e19d46d8d8aac80fe996d56a2a86b1931faee849995c9a20b75ac99038a7)

<a id="element-01a1452d-eb78-70f8-ada0-d757a41de99e"></a>

<a id="element-01a1452d-eb79-7c8b-91a0-491070a668b2"></a>

Once you do that, just click on the ![Save](https://docs.mintsd.com/api/reader/assets/assets/images/image8.png?v=c6dfcae62b1da5a56376cb98f40e0a593d8d731e458977d27180f6380454b49d#element-01a1452d-eb78-70f8-ada0-d757a41de99e) button.

<a id="element-01a1452d-eb79-7c92-959a-87649bba21ec"></a>

<a id="element-01a1452d-eb7a-7a1d-be57-aa7e821ebb54"></a>

5. Now you need to create at least one Agent type user. You can do in the Agents>Agents section.
   Right here you need to click on the small ![Add](https://docs.mintsd.com/api/reader/assets/assets/images/image3.png?v=50654a0321a77a3b2271140f1b6a5080d18fbef92f3639b9b83ad57f0fd5735d#element-01a1452d-eb79-7c92-959a-87649bba21ec) button located on the
   right side of the search bar.

<a id="element-01a1452d-eb7a-7c34-823e-0fec78903940"></a>

![First Login: Now you need to create at least one Agent type user. You can do in the Agents>Agents section. Right here you need to click on the small button located on the right side of the search bar.](https://docs.mintsd.com/api/reader/assets/assets/images/image19.png?v=cdd993057318a67d87db41ac62d5839657251c88676dc2b2347dd2b88687c409)

<a id="element-01a1452d-eb7b-7200-b336-48bfec04a16e"></a>

<a id="element-01a1452d-eb7b-7cb5-b51f-4f701d1a9dda"></a>

> Inside, in the ‘Create User’ view, you need to fill up all of the
> required information and click on the ![Save](https://docs.mintsd.com/api/reader/assets/assets/images/image8.png?v=c6dfcae62b1da5a56376cb98f40e0a593d8d731e458977d27180f6380454b49d#element-01a1452d-eb7b-7200-b336-48bfec04a16e) button once you do that.
> Take notice, that you need to select a correct ‘Role’ from the list.

<a id="element-01a1452d-eb7b-7be4-88f5-cc227afe3e62"></a>

![First Login: Inside, in the ‘Create User’ view, you need to fill up all of the required information and click on the button once you do that. Take notice, that you need to select a correct ‘Role’ from the list.](https://docs.mintsd.com/api/reader/assets/assets/images/image21.jpeg?v=5ab51507d54b9c3be9fd4cc20b6be7dd04bcdefb417f98d3498863efc303f805)

<a id="element-01a1452d-eb7c-7a37-95a1-df1cc6e2f535"></a>

> Mint Service Desk includes one predefined Agent role. The Admin section explains how to add and manage system roles.

<a id="element-01a1452d-eb7d-7956-825c-140734dde6c1"></a>

6. After creating the Agent, the first sign-in attempt sends a verification email to the address entered during account creation. The Agent must confirm that address before beginning work.

