> 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/it/aiuto/troubleshooting/daemon-wont-start.md).

# Il processo in background non si avvia

Correggere il processo in background di Devolutions CLI quando non si avvia o smette di rispondere, controllarlo, riavviarlo e rivedere le impostazioni --daemon che lo tengono spento.

Un comando si ferma con `daemonUnavailable`, `daemonTimeout` o `daemonIoError`, oppure si blocca prima di fare qualcosa. Questi errori provengono dal processo in background che `devo` avvia per parlare con lo spazio di lavoro. Il loro codice di uscita è `3`.

Il più delle volte non vede mai questo processo: il primo comando che ha bisogno dello spazio di lavoro lo avvia, i successivi lo riusano, e si ferma da solo dopo 60 minuti senza uso. Consulti [Come funziona Devolutions CLI](/cli/it/guide/understand/how-it-works.md#the-background-process).

## Perché accade

* Un’impostazione dice a `devo` di non avviare il processo: `--daemon require`, `--daemon never` o `--no-daemon-autostart`, oppure le variabili d’ambiente corrispondenti.
* Il processo è in esecuzione, ma per un’altra cartella di configurazione.
* Il processo ha smesso di rispondere, oppure uno precedente non si è arrestato in modo pulito.
* Una variabile d’ambiente che controlla il processo ha un valore che non può leggere.
* La configurazione del profilo locale è protetta e deve prima essere sbloccata.

## Lo corregga

{% stepper %}
{% step %}

### Verifichi il processo

```bash
devo daemon status
```

`Daemon running` con il suo numero di processo significa che un processo in background è attivo. Quando ne sono registrati diversi, questo è quello preferito e può servire una cartella di configurazione diversa dalla sua: `devo doctor` lo dice allora in una riga `Hint:`. `Daemon not running` significa che non ne è stato trovato nessuno. Per maggiori dettagli, `devo daemon sessions --details` elenca i processi in background registrati, con la cartella di configurazione che ciascuno serve.
{% endstep %}

{% step %}

### Avviarlo o ripararlo

```bash
devo daemon ensure
```

Avvia il processo se nessuno è in esecuzione, ripara una registrazione che non risponde più e mostra lo stato. Se il processo si comporta ancora male, lo riavvii:

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

`--wait` attende che il vecchio processo si fermi prima di avviare quello nuovo. Per fermarlo senza riavviarlo, usi `devo daemon stop --wait`. Il comando successivo che ne ha bisogno lo avvia di nuovo.
{% endstep %}

{% step %}

### Verifichi le impostazioni che lo tengono disattivato

<table><thead><tr><th width="330">MESSAGGIO</th><th>CHE COSA FARE</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> usa solo un processo già in esecuzione. Esegua prima <code>devo daemon ensure</code>, oppure torni a <code>--daemon auto</code>.</td></tr><tr><td>"… --no-daemon-autostart (or DEVO_DAEMON_AUTOSTART) prevents starting one."</td><td>Rimuova <code>--no-daemon-autostart</code>, oppure annulli <code>DEVO_DAEMON_AUTOSTART</code> (i valori <code>0</code>, <code>false</code> e <code>no</code> disattivano l’avvio automatico). Oppure esegua prima <code>devo daemon ensure</code>.</td></tr><tr><td>"Daemon-backed commands are disabled by --daemon never."</td><td>Il comando ha bisogno del processo. Usi <code>--daemon auto</code> o <code>require</code>, e controlli che <code>DEVO_DAEMON_MODE</code> non sia impostato su <code>never</code>.</td></tr><tr><td>"Unsupported DEVO_DAEMON_MODE '&#x3C;value>'. Use auto, require, or never."</td><td>Corregga <code>DEVO_DAEMON_MODE</code>, o annulli l’impostazione.</td></tr><tr><td>"DEVO_DAEMON_IDLE_TIMEOUT must be a duration like 30s, 15m, 1h, or 00:30:00."</td><td>Corregga <code>DEVO_DAEMON_IDLE_TIMEOUT</code>, o annulli l’impostazione.</td></tr></tbody></table>

Consulti [Opzioni globali](/cli/it/riferimento/global-options.md) e [Variabili d’ambiente](/cli/it/riferimento/environment-variables.md).
{% endstep %}

{% step %}

### Verifichi la cartella di configurazione

Ogni cartella di configurazione ha il proprio processo in background, quindi due terminali che usano cartelle diverse non ne condividono uno. Se un messaggio dice "the running daemon serves another root", il processo in esecuzione è per un’altra cartella. Nella modalità predefinita `--daemon auto`, `devo` ne avvia uno per la cartella da solo. Con `require` o `--no-daemon-autostart`, esegua `devo daemon ensure` dal terminale che ne ha bisogno.

`devo config path` stampa la cartella di configurazione che `devo` usa, senza avviare nulla.
{% endstep %}

{% step %}

### Verifichi il runtime dello spazio di lavoro

Quando il processo è in esecuzione ma i comandi su un profilo locale non riescono, controlli che cosa ha caricato:

```bash
devo runtime status
```

Mostra se il runtime è caricato, la cartella del profilo e lo spazio di lavoro in uso, e il motivo quando qualcosa è bloccato. Dopo aver modificato il profilo fuori da Devolutions CLI, per esempio in Devolutions Remote Desktop Manager, lo ricarichi:

```bash
devo runtime reload
```

Se la configurazione del profilo locale è protetta da una password dell’applicazione, la sblocchi per il processo in esecuzione. La password è letta da una variabile d’ambiente o da un file:

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

{% endstep %}
{% endstepper %}

{% hint style="info" %}
Per vedere quando `devo` avvia il processo, aggiunga `--verbose` a un comando: l’avviso `Starting Devolutions CLI daemon...` va all’errore standard, anche con `--output json`.
{% endhint %}

## Non riesce ancora?

Esegua `devo doctor`: controlla il processo senza avviarne uno e le righe `Hint:` suggeriscono cosa fare dopo. Quindi [raccolga la diagnostica](/cli/it/aiuto/troubleshooting/collect-diagnostics.md) e contatti il [supporto 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/it/aiuto/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.