> For the complete documentation index, see [llms.txt](https://help.glpi-project.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.glpi-project.org/faq/glpi/general_setup.md).

# 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](/files/hAJJxPWKSfwgiQAMFmJR) 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](/tutorials/readme-1/calendar.md) 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](/tutorials/readme-1/calendar.md) 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="/files/Rtcn4HVP5S4vfRwLVubI" 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](/tutorials/readme-1/field_unicity.md).

***

### 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="/files/4NeOBPMUT6pe4RzaQi7u" 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>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://help.glpi-project.org/faq/glpi/general_setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
