> For the complete documentation index, see [llms.txt](https://docs.devolutions.net/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.devolutions.net/cli/fr/aide/troubleshooting/daemon-wont-start.md).

# Le processus en arrière-plan ne démarre pas

Corriger le processus en arrière-plan de Devolutions CLI quand il ne démarre pas ou cesse de répondre, en le vérifiant, en le redémarrant, et en revoyant les paramètres --daemon qui le laissent arrêté

Une commande s’arrête avec `daemonUnavailable`, `daemonTimeout` ou `daemonIoError`, ou reste bloquée avant de faire quoi que ce soit. Ces erreurs viennent du processus en arrière-plan que `devo` démarre pour parler à votre espace de travail. Leur code de sortie est `3`.

La plupart du temps, vous ne voyez jamais ce processus : la première commande qui a besoin de votre espace de travail le démarre, les suivantes le réutilisent, et il s’arrête de lui-même après 60 minutes sans utilisation. Consultez [Fonctionnement de Devolutions CLI](/cli/fr/guides/understand/how-it-works.md#the-background-process).

## Pourquoi cela se produit

* Un paramètre dit à `devo` de ne pas démarrer le processus : `--daemon require`, `--daemon never` ou `--no-daemon-autostart`, ou les variables d’environnement correspondantes.
* Le processus est en cours d’exécution, mais pour un autre dossier de configuration.
* Le processus a cessé de répondre, ou un précédent ne s’est pas arrêté proprement.
* Une variable d’environnement qui contrôle le processus a une valeur qu’il ne peut pas lire.
* La configuration du profil local est protégée et doit d’abord être déverrouillée.

## Corrigez-le

{% stepper %}
{% step %}

### Vérifiez le processus

```bash
devo daemon status
```

`Daemon running` avec son numéro de processus signifie qu’un processus en arrière-plan est actif. Quand plusieurs sont inscrits, celui-ci est le préféré, et il peut servir un autre dossier de configuration que le vôtre : `devo doctor` le dit alors dans une ligne `Hint:`. `Daemon not running` signifie qu’aucun n’a été trouvé. Pour plus de détail, `devo daemon sessions --details` énumère les processus en arrière-plan inscrits, avec le dossier de configuration que chacun sert.
{% endstep %}

{% step %}

### Le démarrer ou le réparer

```bash
devo daemon ensure
```

Il démarre le processus si aucun n’est en cours, répare une inscription qui ne répond plus et affiche l’état. Si le processus se comporte encore mal, redémarrez-le :

```bash
devo daemon restart --wait
```

`--wait` attend que l’ancien processus s’arrête avant d’en démarrer un nouveau. Pour l’arrêter sans le redémarrer, utilisez `devo daemon stop --wait`. La prochaine commande qui en a besoin le redémarre.
{% endstep %}

{% step %}

### Vérifiez les paramètres qui le gardent désactivé

<table><thead><tr><th width="330">MESSAGE</th><th>QUOI FAIRE</th></tr></thead><tbody><tr><td>"The Devolutions CLI daemon is not running, and --daemon require (or DEVO_DAEMON_MODE=require) prevents starting one."</td><td><code>require</code> n’utilise qu’un processus déjà en cours. Exécutez d’abord <code>devo daemon ensure</code>, ou revenez à <code>--daemon auto</code>.</td></tr><tr><td>"… --no-daemon-autostart (or DEVO_DAEMON_AUTOSTART) prevents starting one."</td><td>Retirez <code>--no-daemon-autostart</code>, ou annulez <code>DEVO_DAEMON_AUTOSTART</code> (les valeurs <code>0</code>, <code>false</code> et <code>no</code> désactivent le démarrage automatique). Ou exécutez d’abord <code>devo daemon ensure</code>.</td></tr><tr><td>"Daemon-backed commands are disabled by --daemon never."</td><td>La commande a besoin du processus. Utilisez <code>--daemon auto</code> ou <code>require</code>, et vérifiez que <code>DEVO_DAEMON_MODE</code> n’est pas défini à <code>never</code>.</td></tr><tr><td>"Unsupported DEVO_DAEMON_MODE '&#x3C;value>'. Use auto, require, or never."</td><td>Corrigez <code>DEVO_DAEMON_MODE</code>, ou retirez-la.</td></tr><tr><td>"DEVO_DAEMON_IDLE_TIMEOUT must be a duration like 30s, 15m, 1h, or 00:30:00."</td><td>Corrigez <code>DEVO_DAEMON_IDLE_TIMEOUT</code>, ou retirez-la.</td></tr></tbody></table>

Consultez [Options globales](/cli/fr/reference/global-options.md) et [Variables d’environnement](/cli/fr/reference/environment-variables.md).
{% endstep %}

{% step %}

### Vérifiez le dossier de configuration

Chaque dossier de configuration a son propre processus en arrière-plan, donc deux terminaux qui utilisent des dossiers différents n’en partagent pas un. Si un message dit « the running daemon serves another root », le processus qui s’exécute est pour un autre dossier. Dans le mode par défaut `--daemon auto`, `devo` en démarre un pour votre dossier de lui-même. Avec `require` ou `--no-daemon-autostart`, exécutez `devo daemon ensure` depuis le terminal qui en a besoin.

`devo config path` affiche le dossier de configuration que `devo` utilise, sans rien démarrer.
{% endstep %}

{% step %}

### Vérifiez le runtime de l’espace de travail

Quand le processus tourne mais que les commandes sur un profil local échouent, vérifiez ce qu’il a chargé :

```bash
devo runtime status
```

Il indique si le runtime est chargé, le dossier de profil et l’espace de travail en usage, et la raison quand quelque chose est bloqué. Après avoir modifié le profil en dehors de Devolutions CLI, par exemple dans Devolutions Remote Desktop Manager, rechargez-le :

```bash
devo runtime reload
```

Si la configuration du profil local est protégée par un mot de passe d’application, déverrouillez-la pour le processus en cours. Le mot de passe est lu depuis une variable d’environnement ou un fichier :

```bash
devo config unlock --password-env <VARIABLE_NAME> --yes
```

{% endstep %}
{% endstepper %}

{% hint style="info" %}
Pour voir quand `devo` démarre le processus, ajoutez `--verbose` à une commande : l’avis `Starting Devolutions CLI daemon...` va vers la sortie d’erreur, même avec `--output json`.
{% endhint %}

## Toujours en échec ?

Exécutez `devo doctor` : il vérifie le processus sans en démarrer un, et ses lignes `Hint:` indiquent la suite. Ensuite, [collectez les diagnostics](/cli/fr/aide/troubleshooting/collect-diagnostics.md) et communiquez avec le [soutien Devolutions](https://devolutions.net/support/).


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.devolutions.net/cli/fr/aide/troubleshooting/daemon-wont-start.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.