---
title: "Academy Article"
canonical_url: "https://academy.laioutr.com/artikel/laioutr-cli-befehle-und-authentifizierung"
locale: de
meta:
  "og:title": "Academy Article"
---

[Zur Startseite](https://academy.laioutr.com/)

- [Für Entwickler](https://academy.laioutr.com/bereiche/fuer-entwickler)

- [Einstieg für Entwickler](https://academy.laioutr.com/leitfaeden/einstieg-fuer-entwickler)

- [Die Laioutr CLI: Befehle und Authentifizierung](https://academy.laioutr.com/artikel/laioutr-cli-befehle-und-authentifizierung)

# Die Laioutr CLI: Befehle und Authentifizierung

Die Laioutr CLI lädt die Projektkonfiguration laioutrrc.json, gibt App-Versionen im Cockpit frei und löst Deployments aus. Installiert wird sie mit pnpm install -g @laioutr/cli@latest oder ohne Installation per npx.

## Bevor du startest

<dl>

<dt>Rolle</dt>
<dd>Für rc fetch das Project Secret, für app release und deploy einen Organisations-API-Key</dd>

<dt>Dauer</dt>
<dd>6 Min.</dd></dl>

### Voraussetzungen

- Node.js und pnpm oder npx
- Organisations-API-Key mit passendem Scope

Zuletzt geprüft am 15. Oktober 2026

Die CLI verbindet lokale Entwicklung und CI-Pipelines mit dem Cockpit. Dafür gibt es drei Befehlsgruppen:

- **rc fetch** und **rc update** laden bzw. aktualisieren die `laioutrrc.json` eines Projekts, optional für eine bestimmte Umgebung.
- **app release** meldet eine bereits in der Registry veröffentlichte App-Version im Cockpit an, inklusive Peer-Abhängigkeiten, Kanal und Einstellungsformular.
- **deploy trigger**, **deploy status**, **deploy logs** und **deploy list** starten und beobachten Deployments, auch als benannte Preview.

Zur Authentifizierung gibt es zwei Wege. `rc fetch` nutzt das Project Secret aus den Projekteinstellungen. `app release` und alle `deploy`-Befehle brauchen einen Organisations-API-Key: mit Scope `app:publish` für Releases und `project:deploy` für Deployments. Der Key wird mit `--key` oder über die Umgebungsvariable `LAIOUTR_API_KEY` übergeben.

Für CI liefern die Deploy-Befehle mit `--json` strukturierte Ausgaben, auch für Fehler.

## Schritt für Schritt

1. 1 ### Schritt 1: CLI installieren

   `pnpm install -g @laioutr/cli@latest` ausführen oder einzelne Befehle mit `npx @laioutr/cli@latest <befehl>` aufrufen.
2. 2 ### Schritt 2: Konfiguration holen

   `laioutr rc fetch -p <org>/<projekt> -s <project-secret>` schreibt die `laioutrrc.json`; mit `-e` lässt sich eine andere Umgebung als **main** wählen. Später genügt `laioutr rc update`.
3. 3 ### Schritt 3: Deployment auslösen

   `laioutr deploy trigger --project <org>/<projekt> --key orgKey_xxx --logs` startet ein Deployment und streamt das Build-Log. `--preview <name>` erzeugt eine benannte Preview, `--no-wait` kehrt sofort zurück.

## Häufige Fragen

Wann wird das Project Secret und wann ein API-Key gebraucht?

Das Project Secret reicht nur für `rc fetch`. Releases und Deployments laufen über einen Organisations-API-Key mit dem Scope `app:publish` bzw. `project:deploy`.

Wie wertet eine CI-Pipeline Fehler aus?

Mit `--json` geben die Deploy-Befehle Fehler als Objekt mit `code`, `message` und `status` aus. Farbcodes entfallen automatisch, sobald die Ausgabe umgeleitet wird.

Wie viele Deployments zeigt deploy list?

Standardmäßig die letzten 20; mit `--limit` lassen sich bis zu 100 abrufen.

## Passend dazu

- [Lokale Entwicklungsumgebung einrichten](https://academy.laioutr.com/artikel/lokale-entwicklungsumgebung-einrichten)15 Min.

  Mit dem App Starter, einem Login in die Laioutr-npm-Registry und der Projektkonfiguration aus dem Cockpit läuft eine eigene Laioutr-App in wenigen Minuten lokal. Der Studio-Befehl Developer: Use Localhost zeigt die lokale Version anschließend direkt in Studio.
- [Die erste eigene App bauen und veröffentlichen](https://academy.laioutr.com/artikel/erste-eigene-app-bauen-und-veroeffentlichen)20 Min.

  Eine eigene App entsteht aus dem App Starter: Paketnamen setzen, Sections, Blocks oder Orchestr-Handler mit registerLaioutrApp registrieren und im Playground testen. Danach bringen npm publish und laioutr app release die Version ins Cockpit, und das nächste Deployment einer Umgebung rollt sie aus.
- [API-Keys anlegen und verwalten](https://academy.laioutr.com/artikel/api-keys-anlegen-und-verwalten)6 Min.

  API-Keys werden in den Organisationseinstellungen unter API-Keys erstellt. Ein Organisationsschlüssel authentifiziert CLI und CI/CD, ein eingeschränkter Schlüssel gibt einer externen Anwendung nur Zugriff auf die Medien eines Projekts.
- [Deployment starten und prüfen](https://academy.laioutr.com/artikel/deployment-starten-und-pruefen)5 Min.

  Ein Deployment baut die Storefront einer Umgebung neu und bringt Änderungen an Apps, Versionen und Konfiguration live. Gestartet wird es in Cockpit unter Deployments mit Deploy; Status und Build-Log zeigen, ob es erfolgreich war.

## In einer Lektion lernen

- [Lokale Entwicklung und Laioutr CLI](https://academy.laioutr.com/lektionen/entwickler-lokale-entwicklung-und-cli)12 Min.

## [Einstieg für Entwickler](https://academy.laioutr.com/leitfaeden/einstieg-fuer-entwickler)

In diesem Leitfaden suchen

1. [Lokale Entwicklungsumgebung einrichten](https://academy.laioutr.com/artikel/lokale-entwicklungsumgebung-einrichten)15 Min.
2. [Die Laioutr CLI: Befehle und Authentifizierung](https://academy.laioutr.com/artikel/laioutr-cli-befehle-und-authentifizierung)6 Min.
3. [Die erste eigene App bauen und veröffentlichen](https://academy.laioutr.com/artikel/erste-eigene-app-bauen-und-veroeffentlichen)20 Min.
4. [Eigene Sections und Blocks für Studio definieren](https://academy.laioutr.com/artikel/eigene-sections-und-blocks-fuer-studio-definieren)15 Min.
5. [Orchestr: Entities, Queries, Actions und Resolver](https://academy.laioutr.com/artikel/orchestr-entities-queries-actions-und-resolver)8 Min.
6. [Content Collections im Code deklarieren](https://academy.laioutr.com/artikel/content-collections-im-code-deklarieren)15 Min.
7. [Performance und technisches SEO im Code](https://academy.laioutr.com/artikel/performance-und-technisches-seo-im-code)10 Min.

## Structured Data

```json
{
  "@context": "https://schema.org",
  "@graph": [
    {
      "@id": "https://academy.laioutr.com/#website",
      "@type": "WebSite",
      "inLanguage": "de",
      "name": "Default",
      "url": "https://academy.laioutr.com/",
      "workTranslation": {
        "@id": "https://academy.laioutr.com/#website"
      }
    },
    {
      "@id": "https://academy.laioutr.com/artikel/laioutr-cli-befehle-und-authentifizierung#webpage",
      "name": "Academy Article",
      "url": "https://academy.laioutr.com/artikel/laioutr-cli-befehle-und-authentifizierung",
      "@type": [
        "WebPage",
        "FAQPage"
      ],
      "breadcrumb": {
        "@id": "https://academy.laioutr.com/artikel/laioutr-cli-befehle-und-authentifizierung#breadcrumb"
      },
      "isPartOf": {
        "@id": "https://academy.laioutr.com/#website"
      },
      "mainEntity": [
        {
          "@id": "https://academy.laioutr.com/artikel/laioutr-cli-befehle-und-authentifizierung#/schema/question/1"
        },
        {
          "@id": "https://academy.laioutr.com/artikel/laioutr-cli-befehle-und-authentifizierung#/schema/question/2"
        },
        {
          "@id": "https://academy.laioutr.com/artikel/laioutr-cli-befehle-und-authentifizierung#/schema/question/3"
        }
      ],
      "potentialAction": [
        {
          "@type": "ReadAction",
          "target": [
            "https://academy.laioutr.com/artikel/laioutr-cli-befehle-und-authentifizierung"
          ]
        }
      ]
    },
    {
      "@id": "https://academy.laioutr.com/artikel/laioutr-cli-befehle-und-authentifizierung#breadcrumb",
      "@type": "BreadcrumbList",
      "itemListElement": [
        {
          "@type": "ListItem",
          "name": "Home",
          "item": "https://academy.laioutr.com/",
          "position": 1
        },
        {
          "@type": "ListItem",
          "name": "Für Entwickler",
          "item": "https://academy.laioutr.com/bereiche/fuer-entwickler",
          "position": 2
        },
        {
          "@type": "ListItem",
          "name": "Einstieg für Entwickler",
          "item": "https://academy.laioutr.com/leitfaeden/einstieg-fuer-entwickler",
          "position": 3
        },
        {
          "@type": "ListItem",
          "name": "Die Laioutr CLI: Befehle und Authentifizierung",
          "item": "https://academy.laioutr.com/artikel/laioutr-cli-befehle-und-authentifizierung",
          "position": 4
        }
      ]
    },
    {
      "@id": "https://academy.laioutr.com/artikel/laioutr-cli-befehle-und-authentifizierung#/schema/question/1",
      "@type": "Question",
      "inLanguage": "de",
      "name": "Wann wird das Project Secret und wann ein API-Key gebraucht?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "<p>Das Project Secret reicht nur für <code>rc fetch</code>. Releases und Deployments laufen über einen Organisations-API-Key mit dem Scope <code>app:publish</code> bzw. <code>project:deploy</code>.</p>"
      }
    },
    {
      "@id": "https://academy.laioutr.com/artikel/laioutr-cli-befehle-und-authentifizierung#/schema/question/2",
      "@type": "Question",
      "inLanguage": "de",
      "name": "Wie wertet eine CI-Pipeline Fehler aus?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "<p>Mit <code>--json</code> geben die Deploy-Befehle Fehler als Objekt mit <code>code</code>, <code>message</code> und <code>status</code> aus. Farbcodes entfallen automatisch, sobald die Ausgabe umgeleitet wird.</p>"
      }
    },
    {
      "@id": "https://academy.laioutr.com/artikel/laioutr-cli-befehle-und-authentifizierung#/schema/question/3",
      "@type": "Question",
      "inLanguage": "de",
      "name": "Wie viele Deployments zeigt deploy list?",
      "acceptedAnswer": {
        "@type": "Answer",
        "text": "<p>Standardmäßig die letzten 20; mit <code>--limit</code> lassen sich bis zu 100 abrufen.</p>"
      }
    }
  ]
}
```