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

# El proceso en segundo plano no se inicia

Corregir el proceso en segundo plano de Devolutions CLI cuando no se inicia o deja de responder, comprobarlo, reiniciarlo y revisar los ajustes --daemon que lo mantienen apagado.

Un comando se detiene con `daemonUnavailable`, `daemonTimeout` o `daemonIoError`, o se queda colgado antes de hacer nada. Estos errores vienen del proceso en segundo plano que `devo` inicia para hablar con su espacio de trabajo. Su código de salida es `3`.

La mayoría de las veces no ve nunca este proceso: el primer comando que necesita su espacio de trabajo lo inicia, los siguientes lo reutilizan, y se detiene solo tras 60 minutos sin uso. Consulte [Cómo funciona Devolutions CLI](/cli/es/guias/understand/how-it-works.md#the-background-process).

## Por qué ocurre

* Un ajuste indica a `devo` que no inicie el proceso: `--daemon require`, `--daemon never` o `--no-daemon-autostart`, o las variables de entorno correspondientes.
* El proceso está en ejecución, pero para otra carpeta de configuración.
* El proceso dejó de responder, o uno anterior no se cerró correctamente.
* Una variable de entorno que controla el proceso tiene un valor que no puede leer.
* La configuración del perfil local está protegida y debe desbloquearse primero.

## Corríjalo

{% stepper %}
{% step %}

### Compruebe el proceso

```bash
devo daemon status
```

`Daemon running` con su número de proceso significa que un proceso en segundo plano está en marcha. Cuando hay varios registrados, este es el preferido, y puede servir una carpeta de configuración distinta de la suya: `devo doctor` lo dice entonces en una línea `Hint:`. `Daemon not running` significa que no se encontró ninguno. Para más detalle, `devo daemon sessions --details` enumera los procesos en segundo plano registrados, con la carpeta de configuración que sirve cada uno.
{% endstep %}

{% step %}

### Iniciarlo o repararlo

```bash
devo daemon ensure
```

Inicia el proceso si no hay ninguno en ejecución, repara un registro que ya no responde y muestra el estado. Si el proceso sigue fallando, reinícielo:

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

`--wait` espera a que se detenga el proceso antiguo antes de iniciar el nuevo. Para detenerlo sin reiniciarlo, use `devo daemon stop --wait`. El siguiente comando que lo necesite lo inicia de nuevo.
{% endstep %}

{% step %}

### Compruebe la configuración que lo mantiene desactivado

<table><thead><tr><th width="330">MENSAJE</th><th>QUÉ HACER</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> solo usa un proceso que ya está en ejecución. Ejecute primero <code>devo daemon ensure</code>, o vuelva a <code>--daemon auto</code>.</td></tr><tr><td>"… --no-daemon-autostart (or DEVO_DAEMON_AUTOSTART) prevents starting one."</td><td>Quite <code>--no-daemon-autostart</code>, o anule <code>DEVO_DAEMON_AUTOSTART</code> (los valores <code>0</code>, <code>false</code> y <code>no</code> desactivan el inicio automático). O ejecute primero <code>devo daemon ensure</code>.</td></tr><tr><td>"Daemon-backed commands are disabled by --daemon never."</td><td>El comando necesita el proceso. Use <code>--daemon auto</code> o <code>require</code>, y compruebe que <code>DEVO_DAEMON_MODE</code> no esté definido como <code>never</code>.</td></tr><tr><td>"Unsupported DEVO_DAEMON_MODE '&#x3C;value>'. Use auto, require, or never."</td><td>Corrija <code>DEVO_DAEMON_MODE</code>, o anule su definición.</td></tr><tr><td>"DEVO_DAEMON_IDLE_TIMEOUT must be a duration like 30s, 15m, 1h, or 00:30:00."</td><td>Corrija <code>DEVO_DAEMON_IDLE_TIMEOUT</code>, o anule su definición.</td></tr></tbody></table>

Consulte [Opciones globales](/cli/es/referencia/global-options.md) y [Variables de entorno](/cli/es/referencia/environment-variables.md).
{% endstep %}

{% step %}

### Compruebe la carpeta de configuración

Cada carpeta de configuración tiene su propio proceso en segundo plano, así que dos terminales que usan carpetas distintas no comparten uno. Si un mensaje dice «the running daemon serves another root», el proceso que se ejecuta es para otra carpeta. En el modo predeterminado `--daemon auto`, `devo` inicia uno para su carpeta por sí solo. Con `require` o `--no-daemon-autostart`, ejecute `devo daemon ensure` desde el terminal que lo necesita.

`devo config path` imprime la carpeta de configuración que usa `devo`, sin iniciar nada.
{% endstep %}

{% step %}

### Compruebe el runtime del espacio de trabajo

Cuando el proceso se ejecuta pero los comandos de un perfil local fallan, compruebe lo que cargó:

```bash
devo runtime status
```

Muestra si el runtime está cargado, la carpeta de perfil y el espacio de trabajo en uso, y la razón cuando algo está bloqueado. Después de cambiar el perfil fuera de Devolutions CLI, por ejemplo en Devolutions Remote Desktop Manager, vuelva a cargarlo:

```bash
devo runtime reload
```

Si la configuración del perfil local está protegida por una contraseña de aplicación, desbloquéela para el proceso en ejecución. La contraseña se lee desde una variable de entorno o un archivo:

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

{% endstep %}
{% endstepper %}

{% hint style="info" %}
Para ver cuándo `devo` inicia el proceso, añada `--verbose` a un comando: el aviso `Starting Devolutions CLI daemon...` va al error estándar, incluso con `--output json`.
{% endhint %}

## ¿Sigue fallando?

Ejecute `devo doctor`: comprueba el proceso sin iniciar uno, y sus líneas `Hint:` sugieren qué hacer a continuación. Después, [recopile los diagnósticos](/cli/es/ayuda/troubleshooting/collect-diagnostics.md) y contacte con el [soporte de 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/es/ayuda/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.