> 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/anleitungen/connect/devolutions-server.md).

# Bei Devolutions Server anmelden

Bei Devolutions Server von Devolutions CLI aus anmelden, mit dem Browser, einem API-Schlüssel, einem Benutzernamen und einem Passwort oder der Windows-Authentifizierung.

Melden Sie sich einmal an, und Devolutions CLI speichert Ihren Devolutions Server als Kontext, sodass jeder spätere Befehl ihn verwendet, ohne erneut zu fragen. Devolutions Server bietet mehr Anmeldemethoden als die anderen Workspace-Typen, wählen Sie also die, die dazu passt, wer oder was sich anmeldet.

Sie brauchen die Adresse Ihres Devolutions Server, zum Beispiel `https://<your-server-address>`. Verwenden Sie eine `https`-Adresse.

## Die richtige Option wählen

<table><thead><tr><th width="250">AUSWÄHLEN</th><th>WAS PASSIERT</th><th>VERWENDEN, WENN</th></tr></thead><tbody><tr><td><strong>Browser-Anmeldung</strong> (<code>--oauth</code>)</td><td>Ihr Browser öffnet sich zur Anmeldung. Devolutions CLI bewahrt die Sitzung im sicheren Speicher Ihres Betriebssystems auf und erneuert sie von selbst.</td><td>Sie arbeiten an Ihrem eigenen Computer.</td></tr><tr><td><strong>API-Schlüssel</strong> (<code>--api-key-env</code> oder <code>--api-key-file</code>)</td><td>Devolutions CLI meldet sich mit einem API-Schlüssel an, der aus einer Umgebungsvariable oder einer Datei gelesen wird.</td><td>Ein Skript oder eine CI-Pipeline meldet sich an, ohne dass jemand anwesend ist.</td></tr><tr><td><strong>Benutzername und Passwort</strong> (<code>--username</code> mit <code>--password-env</code> oder <code>--password-file</code>)</td><td>Devolutions CLI meldet sich mit einem Konto von Devolutions Server an. Das Passwort wird aus einer Umgebungsvariable oder einer Datei gelesen.</td><td>Sie verwenden ein Devolutions Server-Konto, ein Domänenkonto oder einen Anwendungsbenutzer.</td></tr><tr><td><strong>Windows-Authentifizierung</strong> (<code>--windows-auth</code>)</td><td>Devolutions CLI meldet sich als Ihr aktuelles Windows-Konto an. Kein Passwort anzugeben.</td><td>Sie sind unter Windows, und Ihr Devolutions Server akzeptiert die Windows-Authentifizierung.</td></tr></tbody></table>

Verwenden Sie genau eine Methode pro Anmeldung. Devolutions CLI lehnt einen Befehl ab, der zwei kombiniert.

## Anmelden

{% tabs %}
{% tab title="Browser" %}

```bash
devo login <context-name> --server https://<your-server-address> --oauth
```

Ihr Browser öffnet sich. Wenn nicht, kopieren Sie die im Terminal angezeigte Adresse in einen Browser.

Fügen Sie auf einem Computer ohne Browser `--use-device-code` hinzu und folgen Sie den Anweisungen im Terminal, um sich von einem anderen Gerät aus anzumelden. Wenn die Anmeldeseite einen Bestätigungscode verlangt, geben Sie den im Terminal angezeigten Code ein.
{% endtab %}

{% tab title="API key" %}
Legen Sie den API-Schlüssel in eine Umgebungsvariable oder eine Datei, die nur Sie lesen können, und dann:

```bash
devo login <context-name> --server https://<your-server-address> --api-key-env <VARIABLE_NAME>
```

Oder aus einer Datei:

```bash
devo login <context-name> --server https://<your-server-address> --api-key-file <path-to-file>
```

{% endtab %}

{% tab title="Username and password" %}
Legen Sie das Passwort in eine Umgebungsvariable oder eine Datei, die nur Sie lesen können, und dann:

```bash
devo login <context-name> --server https://<your-server-address> --username <username> --password-env <VARIABLE_NAME>
```

* Fügen Sie für ein Domänenkonto `--domain-id <domain-id>` hinzu.
* Fügen Sie für einen Anwendungsbenutzer `--as-application` hinzu.
  {% endtab %}

{% tab title="Windows authentication" %}

```bash
devo login <context-name> --server https://<your-server-address> --windows-auth
```

Nur unter Windows verfügbar.
{% endtab %}
{% endtabs %}

Devolutions CLI prüft die Anmeldung bei Ihrem Devolutions Server, bevor es den Kontext speichert. Der neue Kontext wird der aktuelle.

{% hint style="info" %}
Devolutions CLI speichert keine API-Schlüssel und keine Passwörter. Es speichert den Namen der Umgebungsvariable oder den Pfad der Datei und liest den Wert jedes Mal erneut, wenn ein Befehl ihn braucht. Lassen Sie diese Variable gesetzt, oder diese Datei an ihrem Platz, solange Sie den Kontext verwenden.
{% endhint %}

## Die Sitzung prüfen und beenden

* `devo status` zeigt den aktuellen Kontext und ob er eine Anmeldung hat. Fügen Sie `--online` hinzu, um Devolutions Server zu kontaktieren und zu bestätigen, dass die Anmeldung noch funktioniert.
* `devo info` zeigt Informationen über Ihren Devolutions Server. Fügen Sie `--private` hinzu, um die Informationen einzuschließen, die Ihre Anmeldung brauchen.
* `devo logout` löscht die Anmeldung des aktuellen Kontexts oder des Kontexts, den Sie nennen. Der Kontext bleibt, sodass Sie sich mit demselben Namen erneut anmelden können.
* `devo context delete <context-name> --yes` entfernt den Kontext und seine gespeicherte Sitzung.

## Gut zu wissen

* `--timeout` legt fest, wie lange Devolutions CLI in Sekunden auf jede Anmeldeanforderung wartet: von `3` bis `600`, standardmäßig `15`.
* `--no-set-current` speichert den Kontext, ohne ihn zum aktuellen zu machen. Wenn noch kein Devolutions Server-Kontext aktuell ist, wird er trotzdem derjenige, den `--source server` verwendet.
* Bei Benutzername und Passwort oder Windows-Authentifizierung enthält die Anmeldeanfrage Ihren Computernamen und Ihren lokalen Benutzernamen. Siehe [Welche Daten Devolutions CLI sendet](/cli/de/anleitungen/understand/privacy.md).
* `devo entry references` listet nur kanonische Referenzen für Einträge von Devolutions Server auf. Siehe [Workspace-Typen vergleichen](/cli/de/anleitungen/understand/workspace-types.md).
* Die Anmeldung schlägt fehl oder die Sitzung ist abgelaufen? Siehe [Die Anmeldung schlägt fehl oder die Sitzung ist abgelaufen](/cli/de/hilfe/troubleshooting/sign-in-fails.md).

## Weiter

* [Find the reference to a secret](/cli/de/anleitungen/secrets/find-a-reference.md)
* [Sign in from a CI pipeline](/cli/de/fur-devops-und-administratoren/automate/ci-sign-in.md)


---

# 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/anleitungen/connect/devolutions-server.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.
