> 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/documentation/12-en/glpi-command-line-interface-cli/available-commands.md).

# Available commands

GLPI includes a CLI tool to help you manage your GLPI instance. This interface is provided by the `bin/console` script which can be executed from the root of your GLPI directory.

> Example: **`sudo -u www-data php bin/console system:status`**

Each command can have zero or more arguments or options. Arguments are positional pieces of information while options are not and are prefixed by one or two hyphens.

{% hint style="success" %}
To view available commands, you can use the command **`php bin/console list`** or add **`--help`** at the end of a command to view available arguments.
{% endhint %}

***

## <i class="fa-computer">:computer:</i> Assets

### glpi:assets:cleansoftware

Alias: `assets:cleansoftware`

> Remove uninstalled software versions and software without versions.

#### Options:

| Name  | Shortcut | Description                                | Required | Default | Array | Negotiable |
| ----- | -------- | ------------------------------------------ | -------- | ------- | ----- | ---------- |
| --max | -m       | Maximum number of items to process per run | Yes      | 500     | No    | No         |

### glpi:assets:purgesoftware

Alias: `assets:purgesoftware`

> Purge unversioned software that has been deleted.

#### Options:

| Name | Shortcut | Description                                | Required | Default | Array | Negotiable |
| ---- | -------- | ------------------------------------------ | -------- | ------- | ----- | ---------- |
| -max | -m       | Maximum number of items to process per run | Yes      | 500     | No    | No         |

### From the GLPI Web Interface

***

## <i class="fa-building">:building:</i> Build

### glpi:build:compile\_scss

Alias: `build:compile_scss`

> Compile an SCSS file.

#### Options:

| Name      | Shortcut | Description                                                         | Required | Default | Array | Negotiable |
| --------- | -------- | ------------------------------------------------------------------- | -------- | ------- | ----- | ---------- |
| --file    | -f       | File to compile (compiles all SCSS files by default)                | No       | \[]     | Yes   | Yes        |
| --dry-run |          | Simulate compilation without actually saving the compiled CSS files | No       |         | No    | No         |

***

## <i class="fa-memory">:memory:</i> Cache

### glpi:cache:clear

Alias: `cache:clear, glpi:system:clear_cache, system:clear_cache`

> Clear the GLPI cache.

#### Options:

| Name      | Shortcut | Description                                                                                          | Required | Default | Array | Negotiable |
| --------- | -------- | ---------------------------------------------------------------------------------------------------- | -------- | ------- | ----- | ---------- |
| --context | -c       | Cache context to clear (e.g., 'core' or 'plugin:plugin\_name'). All contexts are cleared by default. | Yes      | \[]     | Yes   | No         |

### glpi:cache:configure

Alias: `cache:configure`

> Set cache configuration

#### Options:

| Name                     | Shortcut | Description                                                                           | Required | Default | Array | Negotiable |
| ------------------------ | -------- | ------------------------------------------------------------------------------------- | -------- | ------- | ----- | ---------- |
| --context                |          | Cache context (e.g., 'core' or 'plugin:plugin\_name')                                 | Yes      | core    | No    | No         |
| --dsn                    |          | Cache system DSN                                                                      | Yes      | \[]     | Yes   | No         |
| --use-default            |          | Disable cache configuration to use the default filesystem cache for the given context | No       |         | No    | No         |
| --skip-connection-checks |          | Skip connection checks                                                                | No       |         | No    | No         |

{% hint style="info" %}
**Help**

Valid cache systems:

* Memcached
* Redis (TCP)
* Redis (TLS)

Memcached DSN format:

* memcached://\[user:pass@]\[ip|host|socket\[:port]]\[?weight=int]

Redis (TCP) DSN format:

* redis\://\[pass@]\[ip|host|socket\[:port]]\[/db-index]

Redis (TLS) DSN format:

* rediss\://\[pass@]\[ip|host|socket\[:port]]\[/db-index]

The cache namespace can be used to ensure either separation or sharing of data from multiple GLPI instances on the same cache system.
{% endhint %}

### Usage

> * glpi:cache:configure --use-default
> * glpi:cache:configure --dsn=memcached://cache1.glpi-project.org --dsn=memcached://cache2.glpi-project.org
> * glpi:cache:configure --dsn=redis\://redis.glpi-project.org:6379/glpi

### glpi:cache:debug

Alias: `cache:debug`

> Debug GLPI cache.

#### Options:

| Name      | Shortcut | Description                                                     | Required | Default | Array | Negotiable |
| --------- | -------- | --------------------------------------------------------------- | -------- | ------- | ----- | ---------- |
| --key     | -k       | Cache key to debug.                                             | Yes      | \[]     | Yes   | No         |
| --context | -c       | Cache context to clear (e.g., 'core' or 'plugin:plugin\_name'). | Yes      | core    | No    | No         |

### glpi:cache:set\_namespace\_prefix

Alias: `cache:set_namespace_prefix`

> Set cache namespace prefix

#### Arguments (in order):

| Name   | Description      | Required | Default |
| ------ | ---------------- | -------- | ------- |
| prefix | Namespace prefix | Yes      |         |

***

## <i class="fa-command">:command:</i> Completion

### glpi:completion

Alias: `completion`

> Display shell completion script

#### Static Installation

{% stepper %}
{% step %}
Generate the script into a global completion file and restart your shell:

**`bin/console completion nologin | sudo tee /etc/bash_completion.d/console`**

Or save the script to a local file and execute it:

**`bin/console completion nologin > completion.sh`**
{% endstep %}

{% step %}
Source the file on each project usage:

**`source completion.sh`**

Or add this line to the end of your `~/.bashrc` file:

**`source /path/to/completion.sh`**
{% endstep %}
{% endstepper %}

#### Dynamic Installation

* Add this to the end of your shell configuration file (e.g., `~/.bashrc`):

**`eval "$(`**[**`/path/to/glpi`**](#user-content-fn-1)[^1]**`/bin/console completion nologin)"`**

***

## <i class="fa-gear">:gear:</i> Config

### glpi:config:set

Alias: `config:set`

> Set configuration value

#### Arguments (in order):

| Name  | Description                                                      | Required | Default |
| ----- | ---------------------------------------------------------------- | -------- | ------- |
| key   | Configuration key                                                | Yes      |         |
| value | Configuration value (omit argument to enter value interactively) | Yes      |         |

#### Options:

| Name      | Shortcut | Description           | Required | Default | Array | Negotiable |
| --------- | -------- | --------------------- | -------- | ------- | ----- | ---------- |
| --context | -c       | Configuration context | Yes      | core    | No    | No         |

***

## <i class="fa-database">:database:</i> Database

### glpi:database:check\_schema\_integrity

Alias : `db:check_schema_integrity, glpi:database:check, db:check`

> Check for schema differences between the current database and the installation file.

#### Options

| Name                                 | Shortcut | Description                                                                                   | Required | Default | Table | Negatable |
| ------------------------------------ | -------- | --------------------------------------------------------------------------------------------- | -------- | ------- | ----- | --------- |
| --strict                             |          | Strict comparison of definitions                                                              | No       |         | No    | No        |
| --check-all-migrations               |          | Check tokens related to all database migrations.                                              | No       |         | No    | No        |
| --check-innodb-migration             |          | Check tokens related to the "MyISAM" to "InnoDB" migration.                                   | No       |         | No    | No        |
| --check-timestamps-migration         |          | Check tokens related to the "datetime" to "timestamp" migration.                              | No       |         | No    | No        |
| --check-utf8mb4-migration            |          | Check tokens related to the "utf8" to "utf8mb4" migration.                                    | No       |         | No    | No        |
| --check-dynamic-row-format-migration |          | Check tokens related to the "DYNAMIC" row format migration.                                   | No       |         | No    | No        |
| --check-unsigned-keys-migration      |          | Check tokens related to the migration of signed integers to unsigned in primary/foreign keys. | No       |         | No    | No        |

### glpi:database:configure

Alias : `db:configure`

> Set database configuration

#### Options :

| Name                   | Shortcut | Description                                                                      | Required | Default   | Table | Negatable |
| ---------------------- | -------- | -------------------------------------------------------------------------------- | -------- | --------- | ----- | --------- |
| --db-host              | -H       | Database host                                                                    | No       | localhost | No    | Yes       |
| --db-name              | -d       | Database name                                                                    | Yes      |           | No    | No        |
| --db-password          | -p       | Database password (value will be prompted if option is passed without value)     | No       |           | No    | Yes       |
| --db-port              | -P       | Database port                                                                    | No       |           | No    | Yes       |
| --db-user              | -u       | Database user                                                                    | Yes      |           | No    | No        |
| --reconfigure          | -r       | Reconfigure the database, overwrite configuration file if it already exists      | No       |           | No    | No        |
| --strict-configuration |          | Use strict configuration to enforce warnings on deprecated or discouraged usages | No       |           | No    | No        |

### glpi:database:enable\_timezones

Alias : `db:enable_timezones`

> Enable timezone usage.

### glpi:database:install

Alias : `db:install`

> Install database schema

#### Options :

| Name                   | Shortcut | Description                                                                                                                            | Required | Default   | Table | Negatable |
| ---------------------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------- | -------- | --------- | ----- | --------- |
| --db-host              | -H       | Database host                                                                                                                          | No       | localhost | No    | Yes       |
| --db-name              | -d       | Database name                                                                                                                          | Yes      |           | No    | No        |
| --db-password          | -p       | Database password (value will be prompted if option is passed without value)                                                           | No       |           | No    | Yes       |
| --db-port              | -P       | Database port                                                                                                                          | No       |           | No    | Yes       |
| --db-user              | -u       | Database user                                                                                                                          | Yes      |           | No    | No        |
| --reconfigure          | -r       | Reconfigure the database, overwrite configuration file if it already exists                                                            | No       |           | No    | No        |
| --strict-configuration |          | Use strict configuration to enforce warnings on deprecated or discouraged usages                                                       | No       |           | No    | No        |
| --default-language     | -L       | Default GLPI language                                                                                                                  | No       | en\_GB    | No    | Yes       |
| --force                | -f       | Force installation execution, overwriting existing database                                                                            | No       |           | No    | No        |
| --enable-telemetry     |          | Allow sending usage statistics to the telemetry service ([https://telemetry.glpi-project.org](https://telemetry.glpi-project.org/))    | No       |           | No    | No        |
| --no-telemetry         |          | Disallow sending usage statistics to the telemetry service ([https://telemetry.glpi-project.org](https://telemetry.glpi-project.org/)) | No       |           | No    | No        |

### glpi:database:update

Alias : `db:update`

> Update database schema to a new version

#### Options

| Name               | Shortcut | Description                                                                                                                            | Required | Default | Table | Negatable |
| ------------------ | -------- | -------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- | ----- | --------- |
| --allow-unstable   | -u       | Allow update to an unstable version                                                                                                    | No       |         | No    | No        |
| --force            | -f       | Force update execution from v-1 of GLPI even if the schema has not changed                                                             | No       |         | No    | No        |
| --enable-telemetry |          | Allow sending usage statistics to the telemetry service ([https://telemetry.glpi-project.org](https://telemetry.glpi-project.org/))    | No       |         | No    | No        |
| --no-telemetry     |          | Disallow sending usage statistics to the telemetry service ([https://telemetry.glpi-project.org](https://telemetry.glpi-project.org/)) | No       |         | No    | No        |

***

## <i class="fa-stethoscope">:stethoscope:</i> Diagnostic

### glpi:diagnostic:check\_documents\_integrity

Alias : `diagnostic:check_documents_integrity`

> Check file integrity for GLPI documents.

### glpi:diagnostic:check\_html\_encoding

Alias : `diagnostic:check_html_encoding`

> Check for improperly encoded HTML content in the database.

#### Options

| Name              | Shortcut | Description                                                                      | Required | Default | Table | Negatable |
| ----------------- | -------- | -------------------------------------------------------------------------------- | -------- | ------- | ----- | --------- |
| --fix \| --no-fix | -f       | Fix detected issues                                                              | No       |         | No    | No        |
| --dump=DUMP       | -d       | Specifies the path to the file where SQL queries to undo changes will be stored. | No       |         | No    | No        |

### glpi:diagnostic:check\_source\_code\_integrity

Alias : `diagnostic:check_source_code_integrity`

> Check GLPI source code file integrity.

| Name             | Shortcut | Description                                      | Required | Default | Table | Nillable |
| ---------------- | -------- | ------------------------------------------------ | -------- | ------- | ----- | -------- |
| --diff           | -d       | Displays differences between modified files      | No       |         | No    | No       |
| --allow-download |          | Allows downloading the GLPI version if necessary | No       |         | No    | No       |

***

## <i class="fa-life-ring">:life-ring:</i> Help

### glpi:help

Alias : `help`

> Displays help for each command

| Name            | Shortcut | Description                                                                                                 | Required | Default | Table | Nillable |
| --------------- | -------- | ----------------------------------------------------------------------------------------------------------- | -------- | ------- | ----- | -------- |
| --format=FORMAT |          | Displays the result according to the selected output format (`txt`, `xml`, `json`, or `md`. Default: `txt`) | No       |         | No    | No       |
| --raw           |          | To display the raw command help                                                                             | No       |         | No    | No       |

***

## <i class="fa-user-gear">:user-gear:</i> LDAP

### glpi:ldap:synchronize\_users

Alias : `ldap:sync`

> Synchronize users with LDAP server information

#### Options

| Name                     | Shortcut | Description                                                                                                                                                                                                                                                                                 | Required | Default | Table | Nillable |
| ------------------------ | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- | ----- | -------- |
| --only-create-new        | -c       | Create only new users                                                                                                                                                                                                                                                                       | No       |         | No    | No       |
| --only-update-existing   | -u       | Update only existing users                                                                                                                                                                                                                                                                  | No       |         | No    | No       |
| --ldap-server-id         | -s       | Synchronize only users attached to this LDAP server                                                                                                                                                                                                                                         | No       | \[]     | Yes   | Yes      |
| --ldap-filter            | -f       | Filter to apply to the LDAP search                                                                                                                                                                                                                                                          | No       |         | No    | Yes      |
| --begin-date             |          | Start date to apply in the "modifyTimestamp" filter (see <http://php.net/manual/en/datetime.formats.php> for supported formats)                                                                                                                                                             | No       |         | No    | Yes      |
| --end-date               |          | End date to apply in the "modifyTimestamp" filter (see <http://php.net/manual/en/datetime.formats.php> for supported formats)                                                                                                                                                               | No       |         | No    | Yes      |
| --deleted-user-strategy  | -d       | <p>Force the strategy used for deleted users (current action configured: "1") Possible values are:</p><ul><li>0: Preserve</li><li>1: Move to trash</li><li>2: Remove dynamic permissions and groups</li><li>3: Disable</li><li>4: Disable + Remove dynamic permissions and groups</li></ul> | No       |         | No    | Yes      |
| --restored-user-strategy | -r       | <p>Force the strategy used for restored users (current action configured: "0") Possible values are:</p><ul><li>0: Do nothing</li><li>1: Restore (remove from trash)</li><li>2: Enable</li></ul>                                                                                             | No       |         | No    | Yes      |

***

## <i class="fa-list">:list:</i> List

### glpi:list

Alias : `list`

> The list command lists all commands

* You can also display commands for a specific namespace:

```bash
bin/console list database
```

* You can also export information in other formats using the --format option:

```bash
bin/console list --format=xml
```

* It is also possible to get the raw list of commands (useful for integrating a command executor):

```bash
bin/console list --raw
```

## <i class="fa-gears">:gears:</i> Maintenance

### glpi:maintenance:disable

Alias : `maintenance:disable`

> Disable maintenance mode

### glpi:maintenance:enable

Alias : `maintenance:enable`

> Enable maintenance mode

#### Options

| Name   | Shortcut | Description                        | Required | Default | Table | Negation |
| ------ | -------- | ---------------------------------- | -------- | ------- | ----- | -------- |
| --text | -t       | Text to display during maintenance | No       |         | No    | Yes      |

***

## <i class="fa-shop">:shop:</i> Marketplace

### glpi:marketplace:download

Alias : `marketplace:download`

> Download a plugin from the GLPI marketplace

#### Arguments (in order):

| Name    | Description | Required | Default |
| ------- | ----------- | -------- | ------- |
| plugins | Plugin key  | Yes      | \[]     |

#### Options

| Name    | Shortcut | Description                                             | Required | Default | Table | Negation |
| ------- | -------- | ------------------------------------------------------- | -------- | ------- | ----- | -------- |
| --force | -f       | Force download even if the plugin is already downloaded | No       |         | No    | No       |

### glpi:marketplace:info

Alias : `marketplace:info`

> Get information about a plugin

#### Arguments (in order):

| Name   | Description | Required | Default |
| ------ | ----------- | -------- | ------- |
| plugin | Plugin key  | Yes      |         |

### glpi:marketplace:search

Alias : `marketplace:search`

> Search the GLPI marketplace

#### Arguments (in order)

| Name | Description | Required | Default |
| ---- | ----------- | -------- | ------- |
| term | Search term | No       |         |

### glpi:marketplace:upgrade

Alias : `marketplace:upgrade`

> Download all plugins to their latest compatible versions, update all active plugins, and reactivate those that were active.

#### Options

| Name                | Shortcut | Description                                                                                              | Required | Default | Table | Negation |
| ------------------- | -------- | -------------------------------------------------------------------------------------------------------- | -------- | ------- | ----- | -------- |
| --username=USERNAME | -u       | Username used during the installation script (among other things to define plugin administration rights) | No       |         | No    | No       |

***

## <i class="fa-left-right">:left-right:</i> Migration

### glpi:migration:appliances\_plugin\_to\_core

Alias : `migration:appliances_plugin_to_core`

> Migrate data from the Appliances plugin to GLPI core tables

#### Options

| Name          | Shortcut | Description                          | Required | Default | Table | Negation |
| ------------- | -------- | ------------------------------------ | -------- | ------- | ----- | -------- |
| --skip-errors | -s       | Do not exit in case of import errors | No       |         | No    | Non      |

### glpi:migration:databases\_plugin\_to\_core

Alias : `migration:databases_plugin_to_core`

> Migrate data from the Databases plugin to GLPI core tables

#### Options

| Name          | Shortcut | Description                          | Required | Default | Table | Negation |
| ------------- | -------- | ------------------------------------ | -------- | ------- | ----- | -------- |
| --skip-errors | -s       | Do not exit in case of import errors | No       |         | No    | Non      |

### glpi:migration:domains\_plugin\_to\_core

Alias : `migration:domains_plugin_to_core`

> Migrate data from the Domains plugin to GLPI core tables

#### Options

| Name          | Shortcut | Description                  | Required | Default | Table | Negation |
| ------------- | -------- | ---------------------------- | -------- | ------- | ----- | -------- |
| --skip-errors | -s       | Do not exit on import errors | No       |         | No    | No       |

### glpi:migration:dynamic\_row\_format

Alias : `migration:dynamic_row_format`

> Convert database tables to "Dynamic" row format (required for "utf8mb4" character set support).

### glpi:migration:formcreator\_plugin\_to\_core

Alias : `migration:formcreator_plugin_to_core`

> Migrate data from the Formcreator plugin to GLPI main tables

| Name              | Shortcut | Description                                                                 | Required | Default | Table | Negation |
| ----------------- | -------- | --------------------------------------------------------------------------- | -------- | ------- | ----- | -------- |
| --dry-run         |          | Simulate the migration                                                      | No       |         | No    | No       |
| --form-id=FORM-ID |          | Import only specific forms with the provided IDs (multiple values allowed). |          |         |       |          |

### glpi:migration:genericobject\_plugin\_to\_core

Alias : `genericobject_plugin_to_core`

> Migrate data from the generic object plugin to GLPI main tables

| Name      | Shortcut | Description            | Required | Default | Table | Negation |
| --------- | -------- | ---------------------- | -------- | ------- | ----- | -------- |
| --dry-run |          | Simulate the migration | No       |         | No    | No       |

### glpi:migration:migrate\_all

Alias : `migration:migrate_all`

> Run all recommended optional migrations.

### glpi:migration:myisam\_to\_innodb

Alias : `migration:myisam_to_innodb`

> Migrate MyISAM tables to InnoDB

### glpi:migration:racks\_plugin\_to\_core

Alias : `migration:racks_plugin_to_core`

> Migrate data from the Racks plugin to GLPI core tables

#### Options

| Name                    | Shortcut | Description                                                                                                                 | Required | Default | Table | Negation |
| ----------------------- | -------- | --------------------------------------------------------------------------------------------------------------------------- | -------- | ------- | ----- | -------- |
| --ignore-other-elements | -i       | Ignore "PluginRacksOther" models and elements                                                                               | No       |         | No    | No       |
| --skip-errors           | -s       | Do not exit on import errors                                                                                                | No       |         | No    | No       |
| --truncate              | -t       | Delete existing core data                                                                                                   | No       |         | No    | No       |
| --update-plugin         | -u       | Run the Racks plugin update (you must have the files for version 1.8.0 to perform this operation)                           | No       |         | No    | No       |
| --without-plugin        | -w       | Enable migration without plugin files (we cannot guarantee that plugin data is compatible with the supported version 1.8.0) | No       |         | No    | No       |

### glpi:migration:timestamps

Alias : `migration:timestamps`

> Convert "datetime" fields to "timestamp" to use timezones.

### glpi:migration:unsigned\_keys

Alias : `migration:timestamps`

> Migrate primary/foreign keys to unsigned integers

### glpi:migration:utf8mb4

Alias : `migration:utf8mb4`

> Convert the database character set from "utf8" to "utf8mb4".

***

## <i class="fa-puzzle">:puzzle:</i> Plugins

### glpi:plugin:activate

Alias : `plugin:activate`

> Activate one or more plugin(s)

#### Arguments (in order) :

| Name      | Description      | Required | Default |
| --------- | ---------------- | -------- | ------- |
| directory | Plugin directory | No       | \[]     |

#### Options

| Name  | Shortcut | Description                    | Required | Default | Table | Negation |
| ----- | -------- | ------------------------------ | -------- | ------- | ----- | -------- |
| --all | -a       | Run the command on all plugins | No       |         | No    | No       |

### glpi:plugin:deactivate

Alias : `plugin:deactivate`

> Deactivate one or more plugin(s)

#### Arguments (in order)

| Name      | Description      | Required | Default |
| --------- | ---------------- | -------- | ------- |
| directory | Plugin directory | No       | \[]     |

#### Options

| Name  | Shortcut | Description                    | Required | Default | Table | Negable |
| ----- | -------- | ------------------------------ | -------- | ------- | ----- | ------- |
| --all | -a       | Run the command on all plugins | No       |         | No    | No      |

### glpi:plugin:install

Alias : `plugin:install`

> Run the plugin installation script(s)

#### Arguments (in order)

| Name      | Description      | Required | Default |
| --------- | ---------------- | -------- | ------- |
| directory | Plugin directory | No       | \[]     |

#### Options

| Name       | Shortcut | Description                                                                                                                                                                                                    | Required | Default | Table | Negable |
| ---------- | -------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- | ----- | ------- |
| --all      | -a       | Run the command on all plugins                                                                                                                                                                                 | No       |         | No    | No      |
| --param    | -p       | <p>Additional parameters to pass to the plugin installation hook function<br><br>- "-p foo" will set the value of parameter "foo" to true<br>- "-p foo=bar" will set the value of parameter "foo" to "bar"</p> | No       | \[]     | Yes   | Yes     |
| --username | -u       | Username used during the installation script (among other things, to define plugin administrator rights)                                                                                                       | Yes      |         | No    | No      |
| --force    | -f       | Force installation execution, even if the plugin is already installed                                                                                                                                          | No       |         | No    | No      |

### Usage

> glpi:plugin:install -p foo=bar -p force myplugin

### glpi:plugin:list

Alias : `plugin:list`

> List installed plugins (from the marketplace or manually installed), enabled, disabled, and those needing updates.

#### Options

| Name            | Shortcut | Description                                     | Required | Default | Table | Negable |
| --------------- | -------- | ----------------------------------------------- | -------- | ------- | ----- | ------- |
| --format=FORMAT | -f       | Output format (table or json), table by default | No       |         | Yes   | No      |
| --path          | -p       | Include the path to the plugins                 |          |         | Yes   |         |

### glpi:plugin:resume\_execution

Alias : `plugin:resume_execution`

> Resume execution of all active plugins

### glpi:plugin:suspend\_execution

Alias : `plugin:suspend_execution`

> Suspend execution of all active plugins

### glpi:plugin:uninstall

> Run the plugin uninstallation script

#### Arguments (in order)

| Name      | Description      | Required | Default |
| --------- | ---------------- | -------- | ------- |
| directory | Plugin directory | No       | \[]     |

***

## <i class="fa-ruler">:ruler:</i> Rules

### glpi:rules:process\_software\_category\_rules

Alias : `rules:process_software_category_rules`

> Process software category rules

#### Options

| Name  | Shortcut | Description                                                                        | Required | Default | Table | Negatable |
| ----- | -------- | ---------------------------------------------------------------------------------- | -------- | ------- | ----- | --------- |
| --all | -a       | Process the rule for all software, even those that already have a defined category | No       |         | No    | No        |

### glpi:rules:replay\_dictionary\_rules

Alias : `rules:replay_dictionary_rules`

> Replay dictionary rules on existing items

#### Options

| Name              | Shortcut | Description                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                    | Required | Default | Table | Negatable |
| ----------------- | -------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | ------- | ----- | --------- |
| --dictionary      | -d       | Dictionary to use. Possible values are: CableType, ComputerModel, ComputerType, DatabaseInstanceType, GlpiSocketModel, ImageFormat, ImageResolution, Manufacturer, MonitorModel, MonitorType, NetworkEquipmentModel, NetworkEquipmentType, OperatingSystem, OperatingSystemArchitecture, OperatingSystemEdition, OperatingSystemKernel, OperatingSystemKernelVersion, OperatingSystemServicePack, OperatingSystemVersion, PeripheralModel, PeripheralType, PhoneModel, PhoneType, Printer, PrinterModel, PrinterType, Software | Yes      |         | No    | No        |
| --manufacturer-id | -m       | If the option is set, only items with the given manufacturer ID will be processed. Currently only available for the Software dictionary.                                                                                                                                                                                                                                                                                                                                                                                       | Yes      |         | No    | No        |

***

## <i class="fa-shield-keyhole">:shield-keyhole:</i> Security

### glpi:security:change\_key

Alias : `security:change_key`

> Change the password storage key and update values in the database.

### glpi:security:change\_oauth\_key

Alias : `security:change_oauth_key`

> (Re)generate OAuth keys

| Name    | Shortcut | Description                                                  | Required | Default | Table | Negatable |
| ------- | -------- | ------------------------------------------------------------ | -------- | ------- | ----- | --------- |
| --force | -f       | Force regeneration of OAuth keys even if they already exist. | No       |         | No    | No        |

### glpi:security:security:disable\_2fa

Alias : `security:disable_2fa`

> Disable 2FA for all users

#### Argument

| Name  | Description                       | Required | Default |
| ----- | --------------------------------- | -------- | ------- |
| login | Disable 2FA for one or more users | No       | \[]     |

***

## <i class="fa-gears">:gears:</i> System

### glpi:system:check\_requirements

Alias : `system:check_requirements`

> Check system requirements

### glpi:system:list\_services

Alias : `system:list_services`

> List system services

### glpi:system:status

Alias : `system:status`

> Check system status

#### Options

| Name      | Shortcut | Description                                                                                                                         | Required | Default | Table | Negatable |
| --------- | -------- | ----------------------------------------------------------------------------------------------------------------------------------- | -------- | ------- | ----- | --------- |
| --private | -p       | Advertise status information. Private status information may contain potentially sensitive information such as version information. | No       |         | No    | No        |
| --service | -s       | The service to check or all                                                                                                         | No       | all     | No    | Yes       |

***

## <i class="fa-clipboard-clock">:clipboard-clock:</i> Task

### glpi:task:unlock

Alias : `task:unlock`

> Unlock automatic tasks

#### Options

| Name    | Shortcut | Description                                                                                            | Required | Default | Table | Negatable |
| ------- | -------- | ------------------------------------------------------------------------------------------------------ | -------- | ------- | ----- | --------- |
| --all   | -a       | Unlock all tasks                                                                                       | No       |         | No    | No        |
| --cycle | -c       | Execution time (in cycles) from which the task is considered blocked (delay = task frequency \* cycle) | No       |         | No    | Yes       |
| --delay | -d       | Execution time (in seconds) from which the task is considered blocked (default: 1800)                  | No       |         | No    | Yes       |
| --task  | -t       | Itemtype::name of the task to unlock (e.g., "MailCollector::mailgate")                                 | No       | \[]     | Yes   | Yes       |

***

## <i class="fa-user-gear">:user-gear:</i> User

### glpi:user:create

Alias : `user:create`

> Create a new GLPI user in the internal database

#### Argument

| Name     | Description                          | Required | Default |
| -------- | ------------------------------------ | -------- | ------- |
| username | Specify the username of the new user | yes      | \[]     |

#### Options

| Name                       | Shortcut | Description                                                                                               | Required | Default | Table | Negatable |
| -------------------------- | -------- | --------------------------------------------------------------------------------------------------------- | -------- | ------- | ----- | --------- |
| --password\[=PASSWORD]     | -p       | Specify the password                                                                                      | No       |         | No    | No        |
| --env=ENV                  |          | Environment to use. Possible values are: `production`, `staging`, `testing`, `e2e_testing`, `development` | No       |         | No    | Yes       |
| --config-dir\[=CONFIG-DIR] |          | Configuration directory to use (this option is obsolete)                                                  | No       |         | No    | Yes       |

### glpi:user:delete

Alias : `user:delete`

> Delete a user

#### Argument

| Name     | Description                                | Required | Default |
| -------- | ------------------------------------------ | -------- | ------- |
| username | Specify the username of the user to delete | Yes      | \[]     |

#### Option

| Name                       | Shortcut | Description                                                                                               | Required | Default | Table | Negatable |
| -------------------------- | -------- | --------------------------------------------------------------------------------------------------------- | -------- | ------- | ----- | --------- |
| --env=ENV                  |          | Environment to use. Possible values are: `production`, `staging`, `testing`, `e2e_testing`, `development` | No       |         | No    | Yes       |
| --config-dir\[=CONFIG-DIR] |          | Configuration directory to use (this option is obsolete)                                                  | No       |         | No    | Yes       |

### glpi:user:disable

Alias : `user:disable`

> Disable a user

#### Argument

| Name     | Description                                 | Required | Default |
| -------- | ------------------------------------------- | -------- | ------- |
| username | Specify the username of the user to disable | Yes      | \[]     |

#### Option

| Name                       | Shortcut | Description                                                                                               | Required | Default | Array | Negatable |
| -------------------------- | -------- | --------------------------------------------------------------------------------------------------------- | -------- | ------- | ----- | --------- |
| --env=ENV                  |          | Environment to use. Possible values are: `production`, `staging`, `testing`, `e2e_testing`, `development` | No       |         | No    | Yes       |
| --config-dir\[=CONFIG-DIR] |          | Configuration directory to use (this option is deprecated)                                                | No       |         | No    | Yes       |

### glpi:user:enable

Alias : `user:enable`

> Enable a user

| Name     | Description                                    | Required | Default |
| -------- | ---------------------------------------------- | -------- | ------- |
| username | Indicates the identifier of the user to enable | Yes      | \[]     |

#### Options

| Name                       | Shortcut | Description                                                                                               | Required | Default | Array | Negatable |
| -------------------------- | -------- | --------------------------------------------------------------------------------------------------------- | -------- | ------- | ----- | --------- |
| --env=ENV                  |          | Environment to use. Possible values are: `production`, `staging`, `testing`, `e2e_testing`, `development` | No       |         | No    | Yes       |
| --config-dir\[=CONFIG-DIR] |          | Configuration directory to use (this option is deprecated)                                                | No       |         | No    | Yes       |

### glpi:user:grant

Alias : `user:grant`

> Assign a profile to a user

| Name     | Description                                                           | Required | Default |
| -------- | --------------------------------------------------------------------- | -------- | ------- |
| username | Indicates the identifier of the user whose profile should be modified | Yes      | \[]     |

#### Options

| Name                       | Shortcut | Description                                                                                               | Required | Default | Array | Negatable |
| -------------------------- | -------- | --------------------------------------------------------------------------------------------------------- | -------- | ------- | ----- | --------- |
| --profile= PROFILE         | -p       | Desired profile                                                                                           | Yes      |         |       |           |
| --entity=ENTITY            | -e       | Entity \[default: 0]                                                                                      | No       |         |       |           |
| --recursive                | -r       | Recursion of the profile on sub-entities                                                                  | No       |         |       |           |
| --env=ENV                  |          | Environment to use. Possible values are: `production`, `staging`, `testing`, `e2e_testing`, `development` | No       |         | No    | Yes       |
| --config-dir\[=CONFIG-DIR] |          | Configuration directory to use (this option is deprecated)                                                | No       |         | No    | Yes       |

### glpi:user:reset\_password

Alias : `user:reset_password`

> Reset a user's password in the internal database

| Name     | Description                                                         | Required | Default |
| -------- | ------------------------------------------------------------------- | -------- | ------- |
| username | Indicates the identifier of the user whose password should be reset | Yes      | \[]     |

#### Options

| Name                       | Shortcut | Description                                                                                               | Required | Default | Array | Negatable |
| -------------------------- | -------- | --------------------------------------------------------------------------------------------------------- | -------- | ------- | ----- | --------- |
| --password\[=PASSWORD]     | -p       | Specify the password                                                                                      | No       |         |       |           |
| --env=ENV                  |          | Environment to use. Possible values are: `production`, `staging`, `testing`, `e2e_testing`, `development` | No       |         | No    | Yes       |
| --config-dir\[=CONFIG-DIR] |          | Configuration directory to use (this option is deprecated)                                                | No       |         | No    | Yes       |

***

## glpi:tools:check\_database\_keys

Alias : `tools:check_database_keys`

### Description

Check the database for missing and erroneous keys.

### Arguments/Options

There are no arguments for this command

Options :

| Name                   | Shortcut | Description          | Required | Default | Array | Negatable |
| ---------------------- | -------- | -------------------- | -------- | ------- | ----- | --------- |
| --detect-misnamed-keys |          | Detect misnamed keys | No       |         | No    | No        |
| --detect-useless-keys  |          | Detect misnamed keys | No       |         | No    | No        |

## glpi:tools:check\_database\_schema\_consistency

Alias : `tools:check_database_schema_consistency`

### Description

Check database schema consistency.

## glpi:toolsdelete\_orphan\_logs

Alias : `tools:delete_orphan_logs`

### Description

Delete orphan logs

### Arguments/Options

There are no arguments for this command

Options :

| Name      | Shortcut | Description                                             | Required | Default | Array | Negatable |
| --------- | -------- | ------------------------------------------------------- | -------- | ------- | ----- | --------- |
| --dry-run |          | Simulate the command without actually deleting anything | No       |         | No    | No        |

[^1]: To be modified with the path to your GLPI instance


---

# 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://help.glpi-project.org/documentation/12-en/glpi-command-line-interface-cli/available-commands.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.
