# General setup

***

### How can I get information on API documentation?

In order to get help on APIs, you can consult the documentation directly from your instance. To do this, in **`setup`** > **`general`** > **`API`** change the option to **`Yes`** to **`enable API Rest`**. The **`online API documentation`** option will appear. If you get an error message when you click on the documentation, click on **`full access from localhost`** and delete the IPs (or enter the IP of the workstation you are on) in the start and end of IPv4 address range fields.

***

### Do you have a password policy?

Yes, for internal accounts only. As external accounts (LDAP, SSO, etc.) depend on a dedicated server, this policy cannot be applied to these accounts.

It is possible to request that the password :

* requires at least one number,
* requires at least one lower case letter,
* requires at least one symbol,
* be of a minimum length (configurable length),
* expires after a set period of time,
* is deactivated if the password has not been changed for a certain period of time (configurable time limit),

It is also possible to request that an expiry notification be sent to users.

***

### How to disable password reset by e-mail?

To disable password reset by e-mail, you need to deactivate the **`Password forget`** notification (**`Setup`** > **`Notifications`** > **`Notifications`**).

***

### Can I increase the password reset time by one day?

When you request a password reset from GLPI, you have 24 hours to carry out the reset. This time cannot be changed. If the 24 hours are exceeded, a new request must be made.

***

### How do I put GLPI into maintenance mode?

If you have operations to perform that require GLPI to be put into maintenance mode, it is possible to do this in 2 ways:

* In CLI (on premise only): in the glpi folder run **`php bin/console maintenance:enable`** (or **`php bin/console maintenance:disable`** to deactivate it)
* In WebUI: in the **`setup`** > **`general`** menu **`system`** tab

{% hint style="success" %}
To override maintenance mode, you can access GLPI by adding **`?skipMaintenance=1`** (*<https://myinstance.com/index.php?skipMaintenance=1>*)
{% endhint %}

***

### How do I purge the GLPI history?

In order not to overload the GLPI database, it is possible to purge the history of certain items:

* general
* software
* financial and administrative information
* users
* components
* all sections (purge all history entries)

By default, the "keep all" option is selected. It is possible to keep the history for between 1 and 120 months, either per section or for the whole.

{% hint style="info" %}
History refers to the **`historical`** tab of a GLPI object.
{% endhint %}

***

### What are locks used for?

Locks are used to prevent certain information from being modified.

{% hint style="success" %}
You don't want the user field to be modified during automatic inventory feedback.
{% endhint %}

In this case, you need to activate the locks in **`Setup`** > **`General`** > **`General setup`**. Select &#x55;**`se locks`** and select the **`profile to be used when locking items`** and the **`types of object to lock`**. To lock a field, simply change it manually. Only the profile you have set up will be able to lock and unlock fields. To unlock them, go to the **`lock`** field of the item in question.

A padlock ![Alt text](https://3250947132-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSvoJ3lioglS2UZLcWWyP%2Fuploads%2Fgit-blob-4263190c3bb0385939741edd509ef33cca3cbba6%2Flock.png?alt=media) will appear when information is locked.

***

### Is it possible to set up working days for support?

Yes, in **`Setup`** > **`General`** tab **`Assistance`** you can set up working days in the **`Planning work days`** field.

***

### How do I change my GLPI theme?

There are several ways to change the theme:

* For individual use: go to **`user settings`** (top right) then in the **`personalization`** tab you can choose the **`color palette`** that suits you.
* For a global setting: go to **`setup`** > **`general`** > **`default values`**. You can choose the colour palette that suits you and will be applied to all users.

You can also modify the CSS by entity. Go to **`administration`** > **`entities`**, select the entity you want, then **`UI customization`**. Indicate **`Yes`** in the **`enable CSS customization`** field and paste your CSS code in the dedicated area.

***

### Can I customise my instance's logo and theme?

You can do this by downloading the **`Branding`** plugin (available on Cloud instances or with a "basic" subscription). Custom palette is available on GLPI 11 only.

***

### How do I assign a default language for all users?

To change the default language, go to **`Setup`** > **`General`** > **`Default values`**. A **`default language`** field is available in the **`personalization`** section. This change is valid for all users.

{% hint style="info" %}
Users will still be able to change their language if they wish from their profile.
{% endhint %}

***

### How do I retrieve my instance's UUID?

Valid for on-premise instances only:

In **`Setup`** > **`General`** click on **`See what would be sent`**. This is the 1st value that will appear:

```
"glpi": {
"uuid": "hQ6ZuLpydjmaTuUCqnaqE6tTdsksio84sdfV8Kb1",
"version": "10.0.18",
}
```

***

### How can I increase the number of search results per page?

In **`Setup`** > **`General`** > **`General setup`**, adjust the **`Default search results limit (page)`** as desired.

***

### How can I deactivate the global search?

In **`Setup`**> **`General`** > **`General configuration`**, put **`No`** to **`Global search`**.

***

### Can I activate/deactivate the option to **"remember me"\`**?

In **`Setup`**> **`General`** > **`General configuration`**, at the bottom of the screen, click on deactivate or indicate in days the possible retention of the identifier.

***

### Can I configure closing days?

It is possible to configure closing days (public holidays) from **`Setup`**> **`Titles`**, enter **`Closing`** and click on **`Closing periods`**. A procedure is [available](https://app.gitbook.com/s/sGALtnzA2IROeldmXKt5/readme-1/calendar) to help you set them up.

***

### Can I increase the password reset time to one day?

When you request a password reset from GLPI, you have 24 hours to reset your password. This time cannot be changed. If the 24 hours are exceeded, a new request must be made. A procedure is [available](https://app.gitbook.com/s/sGALtnzA2IROeldmXKt5/readme-1/calendar) to help you set them up.

***

### Can we synchronize a calendar with GLPI?

GLPI integrates a CalDAV server, which allows sharing of a GLPI calendar externally. It is also possible to modify it from both places. It's native via the link I provided previously.

* To do this, go to **`Assistance`** > **`Planning`**
* Click on
* Then click on **`Copy CalDAV URL to clipboard`**
* Paste this link into your email tool

<div align="left"><img src="https://3250947132-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSvoJ3lioglS2UZLcWWyP%2Fuploads%2Fgit-blob-e55fe081366228a354d554e57aaadd497cf7fd34%2Fcalendar.png?alt=media" alt="alt text"></div>

Copying a link from an external email to GLPI (Outlook calendar type) is not native. You must use a third-party tool (outside the scope of Teclib) such as <https://caldavsynchronizer.org>.

***

### How can I avoid importing duplicates into GLPI?

If you don't want 2 items to have the same serial number, or 2 users to have the same ID, field uniqueness will help you avoid these duplicates. To configure it, you can follow this [procedure](https://app.gitbook.com/s/sGALtnzA2IROeldmXKt5/readme-1/field_unicity).

***

### What types of documents/extentions can be uploaded to GLPI?

From **`Setup`** > **`Dropdowns`** > **`Document types`** you can manage the types of documents authorised to be uploaded to GLPI:

<details>

<summary>Type of documents</summary>

| Name                               | Extension | Authorised by default |
| ---------------------------------- | --------- | --------------------- |
| Adobe Illustrator                  | ai        | Yes                   |
| AIFF                               | aiff      | Yes                   |
| BMP                                | bmp       | Yes                   |
| BZip                               | bz2       | Yes                   |
| Cheader                            | h         | Yes                   |
| Csource                            | c         | Yes                   |
| Comma-Separated Values             | csv       | Yes                   |
| Debian                             | deb       | Yes                   |
| DjVu                               | djvu      | Yes                   |
| DVI                                | dvi       | Yes                   |
| Excel                              | xls       | Yes                   |
| Excel                              | XML/xlsx  | Yes                   |
| Flash                              | swf       | Yes                   |
| GIF                                | gif       | Yes                   |
| GIMP multi-layer                   | xcf       | Yes                   |
| GZ                                 | gz        | Yes                   |
| HTML                               | html      | Yes                   |
| JPEG                               | jpg       | Yes                   |
| JPEG                               | jpeg      | Yes                   |
| JSON file                          | json      | Yes                   |
| LaTeX                              | tex       | Yes                   |
| Midi                               | mid       | Yes                   |
| MNG                                | mng       | Yes                   |
| MP3                                | mp3       | Yes                   |
| MPEG                               | mpg       | Yes                   |
| Oasis Open Office Base             | odb       | Yes                   |
| Oasis Open Office Calc             | ods       | Yes                   |
| Oasis Open Office Calc Template    | ots       | Yes                   |
| Oasis Open Office Chart            | odc       | Yes                   |
| Oasis Open Office Draw             | odg       | Yes                   |
| Oasis Open Office Draw Template    | otg       | Yes                   |
| Oasis Open Office HTML             | oth       | Yes                   |
| Oasis Open Office Image            | odi       | Yes                   |
| Oasis Open Office Impress          | odp       | Yes                   |
| Oasis Open Office Impress Template | otp       | Yes                   |
| Oasis Open Office Math             | odf       | Yes                   |
| Oasis Open Office Writer           | odt       | Yes                   |
| Oasis Open Office Writer Master    | odm       | Yes                   |
| Oasis Open Office Writer Template  | ott       | Yes                   |
| Ogg Vorbis                         | ogg       | Yes                   |
| OpenOffice                         | sxw       | Yes                   |
| OpenOffice Calc                    | sxc       | Yes                   |
| OpenOffice Impress                 | sxi       | Yes                   |
| Pascal                             | pas       | Yes                   |
| PDF                                | pdf       | Yes                   |
| Photoshop                          | psd       | Yes                   |
| PNG                                | png       | Yes                   |
| PostScript                         | eps       | Yes                   |
| PostScript                         | ps        | Yes                   |
| PowerPoint                         | ppt       | Yes                   |
| PowerPoint                         | XML/pptx  | Yes                   |
| QuickTime                          | mov       | Yes                   |
| QuickTime                          | question  | Yes                   |
| RealAudio                          | ra        | Yes                   |
| RealAudio                          | ram       | Yes                   |
| RealAudio                          | rm        | Yes                   |
| RedHat/Mandrake/SuSE               | rpm       | Yes                   |
| RTF                                | rtf       | Yes                   |
| Scalable Vector Graphics           | svg       | Yes                   |
| StarOffice                         | sdd       | Yes                   |
| StarOffice                         | sdw       | Yes                   |
| Stuffit                            | sit       | Yes                   |
| texte                              | txt       | Yes                   |
| TGZ                                | tgz       | Yes                   |
| TIFF                               | tif       | Yes                   |
| WAV                                | wav       | Yes                   |
| Windows Media                      | asf       | Yes                   |
| Windows Media                      | avi       | Yes                   |
| Windows Media                      | wmv       | Yes                   |
| Word                               | doc       | Yes                   |
| Word                               | XML/docx  | Yes                   |
| xml                                | xml       | Yes                   |
| zip                                | zip       | Yes                   |

</details>

{% hint style="success" %}
**Add a document type**

You can authorise a new document type to be added to GLPI by clicking on **`Add`** <img src="https://3250947132-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FSvoJ3lioglS2UZLcWWyP%2Fuploads%2Fgit-blob-9c460689668e79755c6453f28a3d1d912ac06143%2Fadd_type_document.png?alt=media" alt="" data-size="original">&#x20;
{% endhint %}

***

### How to add spaces to notification signatures

To add spaces to your signature, you can add HTML characters as shown below:

`<p>`\
`This is the 1st line`\
`<br>`\
`This is the 2nd line`\
`</p>`&#x20;

***

### Which URLs should be allowed when using a proxy?

* <https://services.glpi-network.com>
* <https://github.com>
* <https://gitlab.teclib.com>
* <https://objects.githubusercontent.com>
* <https://release-assets.githubusercontent.com>
