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

# Der Hintergrundprozess startet nicht

Den Hintergrundprozess von Devolutions CLI beheben, wenn er nicht startet oder nicht mehr antwortet, ihn prüfen, neu starten und die --daemon-Einstellungen ansehen, die ihn ausgeschaltet lassen.

Ein Befehl stoppt mit `daemonUnavailable`, `daemonTimeout` oder `daemonIoError` oder hängt, bevor er etwas tut. Diese Fehler kommen vom Hintergrundprozess, den `devo` startet, um mit Ihrem Workspace zu sprechen. Ihr Exitcode ist `3`.

Meistens sehen Sie diesen Prozess nie: Der erste Befehl, der Ihren Workspace braucht, startet ihn, die folgenden verwenden ihn wieder, und er stoppt von selbst nach 60 Minuten ohne Verwendung. Siehe [So funktioniert Devolutions CLI](/cli/de/anleitungen/understand/how-it-works.md#the-background-process).

## Warum es geschieht

* Eine Einstellung sagt `devo`, den Prozess nicht zu starten: `--daemon require`, `--daemon never` oder `--no-daemon-autostart`, oder die entsprechenden Umgebungsvariablen.
* Der Prozess läuft, aber für einen anderen Konfigurationsordner.
* Der Prozess hat aufgehört zu antworten, oder ein vorheriger hat sich nicht sauber beendet.
* Eine Umgebungsvariable, die den Prozess steuert, hat einen Wert, den er nicht lesen kann.
* Die Konfiguration des lokalen Profils ist geschützt und muss zuerst entsperrt werden.

## Korrigieren Sie es

{% stepper %}
{% step %}

### Prüfen Sie den Prozess

```bash
devo daemon status
```

`Daemon running` mit seiner Prozessnummer bedeutet, dass ein Hintergrundprozess läuft. Wenn mehrere registriert sind, ist dies der bevorzugte, und er kann einen anderen Konfigurationsordner bedienen als Ihren: `devo doctor` sagt das dann in einer Zeile `Hint:`. `Daemon not running` bedeutet, dass keiner gefunden wurde. Für mehr Einzelheiten listet `devo daemon sessions --details` die registrierten Hintergrundprozesse mit dem Konfigurationsordner, den jeder bedient.
{% endstep %}

{% step %}

### Es starten oder reparieren

```bash
devo daemon ensure
```

Er startet den Prozess, wenn keiner läuft, repariert eine Registrierung, die nicht mehr antwortet, und zeigt den Status. Wenn sich der Prozess weiter falsch verhält, starten Sie ihn neu:

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

`--wait` wartet, bis der alte Prozess stoppt, bevor er den neuen startet. Um ihn anzuhalten, ohne neu zu starten, verwenden Sie `devo daemon stop --wait`. Der nächste Befehl, der ihn braucht, startet ihn wieder.
{% endstep %}

{% step %}

### Prüfen Sie die Einstellungen, die es ausgeschaltet halten

<table><thead><tr><th width="330">MELDUNG</th><th>WAS ZU TUN IST</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> verwendet nur einen Prozess, der bereits läuft. Führen Sie zuerst <code>devo daemon ensure</code> aus, oder wechseln Sie zurück zu <code>--daemon auto</code>.</td></tr><tr><td>"… --no-daemon-autostart (or DEVO_DAEMON_AUTOSTART) prevents starting one."</td><td>Entfernen Sie <code>--no-daemon-autostart</code>, oder heben Sie <code>DEVO_DAEMON_AUTOSTART</code> auf (die Werte <code>0</code>, <code>false</code> und <code>no</code> schalten den automatischen Start aus). Oder führen Sie zuerst <code>devo daemon ensure</code> aus.</td></tr><tr><td>"Daemon-backed commands are disabled by --daemon never."</td><td>Der Befehl braucht den Prozess. Verwenden Sie <code>--daemon auto</code> oder <code>require</code>, und prüfen Sie, dass <code>DEVO_DAEMON_MODE</code> nicht auf <code>never</code> gesetzt ist.</td></tr><tr><td>"Unsupported DEVO_DAEMON_MODE '&#x3C;value>'. Use auto, require, or never."</td><td>Korrigieren Sie <code>DEVO_DAEMON_MODE</code>, oder heben Sie die Festlegung auf.</td></tr><tr><td>"DEVO_DAEMON_IDLE_TIMEOUT must be a duration like 30s, 15m, 1h, or 00:30:00."</td><td>Korrigieren Sie <code>DEVO_DAEMON_IDLE_TIMEOUT</code>, oder heben Sie die Festlegung auf.</td></tr></tbody></table>

Siehe [Globale Optionen](/cli/de/referenz/global-options.md) und [Umgebungsvariablen](/cli/de/referenz/environment-variables.md).
{% endstep %}

{% step %}

### Prüfen Sie den Konfigurationsordner

Jeder Konfigurationsordner hat seinen eigenen Hintergrundprozess, daher teilen sich zwei Terminals, die verschiedene Ordner verwenden, keinen. Wenn eine Meldung „the running daemon serves another root“ sagt, läuft der Prozess für einen anderen Ordner. Im Standardmodus `--daemon auto` startet `devo` von selbst einen für Ihren Ordner. Mit `require` oder `--no-daemon-autostart` führen Sie `devo daemon ensure` von dem Terminal aus, das ihn braucht.

`devo config path` gibt den Konfigurationsordner aus, den `devo` verwendet, ohne etwas zu starten.
{% endstep %}

{% step %}

### Prüfen Sie die Workspace-Laufzeit

Wenn der Prozess läuft, aber Befehle für ein lokales Profil fehlschlagen, prüfen Sie, was er geladen hat:

```bash
devo runtime status
```

Es zeigt, ob die Laufzeit geladen ist, den verwendeten Profilordner und Workspace und den Grund, wenn etwas blockiert ist. Nachdem Sie das Profil außerhalb von Devolutions CLI geändert haben, zum Beispiel in Devolutions Remote Desktop Manager, laden Sie es neu:

```bash
devo runtime reload
```

Wenn die Konfiguration des lokalen Profils durch ein Anwendungspasswort geschützt ist, entsperren Sie sie für den laufenden Prozess. Das Passwort wird aus einer Umgebungsvariable oder einer Datei gelesen:

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

{% endstep %}
{% endstepper %}

{% hint style="info" %}
Um zu sehen, wann `devo` den Prozess startet, fügen Sie `--verbose` zu einem Befehl hinzu: Der Hinweis `Starting Devolutions CLI daemon...` geht an die Standardfehlerausgabe, auch mit `--output json`.
{% endhint %}

## Schlägt es immer noch fehl?

Führen Sie `devo doctor` aus: Er prüft den Prozess, ohne einen zu starten, und seine `Hint:`-Zeilen schlagen vor, was als Nächstes zu tun ist. Dann [Diagnosedaten erfassen](/cli/de/hilfe/troubleshooting/collect-diagnostics.md) und den [Devolutions-Support](https://devolutions.net/support/) kontaktieren.


---

# 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/de/hilfe/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.