> For the complete documentation index, see [llms.txt](https://documentation.ocsinventory-ng.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://documentation.ocsinventory-ng.org/administrator-docs/server-setup/configuration/basics/general-configuration.md).

# General configuration

Most configuration options available in the OCS web console can be managed from the **Configurations** **→ General → General Configuration** page.\
This page is divided into five sections:

<details>

<summary>Agent: <strong>configuration options transmitted to the agent during inventory.</strong></summary>

* **Frequency:** defines how often the agent reports inventory data to the server, expressed in hours.
* **Inventory checksum:** determines whether the agent should create and reuse a checksum file to compare the previous inventory with the new one.
* **Inventory log level:** sets the log level used by the agent when sending [Inventory logs](/administrator-docs/server-setup/configuration/advanced/inventory-logs.md) to the server.

</details>

<details>

<summary>Blacklist: policies defining blacklist rules based on predefined lists.</summary>

* **MAC addresses:** enables blacklisting of specific MAC addresses.
* **MAC addresses list:** specifies the list of MAC addresses to blacklist, separated by commas.
* **IP addresses:** enables blacklisting of subnets.
* **IP addresses list:** specifies the list of subnets to blacklist, using CIDR notation and separated by commas.
* **Serial numbers:** enables blacklisting of specific serial numbers.
* **Serial numbers list:** specifies the list of serial numbers to blacklist, separated by commas.

{% hint style="info" %}
Blacklists are used to reject incoming inventories.
{% endhint %}

</details>

<details>

<summary>Deployment: configuration options related to the  <a data-mention href="/user-docs/deployment.md">Deployment</a> feature.</summary>

* **Deployment:** enables or disables deployment features.
* **Period latency:** defines the delay between package executions, expressed in seconds.
* **Automatic retry:** enables automatic redeployment if the initial deployment or execution fails.
* **Max retry:** sets the maximum number of retries allowed per package.
* **Execution timeout:** defines the maximum execution time for packages' [Actions](/user-docs/deployment/actions.md) in seconds.
* **Deployment timeout:** sets the overall timeout for a package deployment, in seconds.

</details>

<details>

<summary>Server: core server configuration settings.</summary>

* **Log level Collection:** defines the log level for inventory collection.
* **Log level Backend:** sets the log level for the OCS Inventory backend application.
* **Log level Django:** configures the log level for the Django backend.
* **Log level Management:** sets the log level for OCS Inventory management commands.
* **Duplicate reconciliation:** specifies the field used to identify and reconcile duplicate computers.
* **Administrative data generation:** selects the mode used for administrative data generation.
* **Software dictionary generation:** select when the software dictionary is refreshed.
* **Agent logs purge:** enables automatic purging of agent logs.
* **Agent logs retention:** defines how long agent logs are retained, in days.
* **Purge deployment packages:** enables automatic deletion of old deployment packages.
* **Max age of deployment packages to purge:** sets the interval, in months, between each deployment package purge.

</details>


---

# 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, and the optional `goal` query parameter:

```
GET https://documentation.ocsinventory-ng.org/administrator-docs/server-setup/configuration/basics/general-configuration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.
