# Apps im Terminal verwalten mit dem Befehl blitz

> Der Befehl blitz listet deine Apps, stellt neue aus dem App Store, als Docker-Image oder von GitHub online, startet sie neu, pausiert sie, führt einen Befehl in ihnen aus, zeigt ihre Logs und ändert ihre Einstellungen. Eine Datei, Node.js 18 oder neuer, ein API-Schlüssel.

Web page: https://blitz.cloud/de/docs/cli/
Updated: 2026-10-15

`blitz` ist ein kleiner Befehl für dein Terminal. Er erledigt das, was du sonst im Dashboard klickst: Apps auflisten, eine neue online stellen, neu starten, Logs lesen, eine Einstellung ändern. Es ist eine einzige Datei und braucht nur Node.js 18 oder neuer.

`blitz` spricht mit demselben Server wie KI-Assistenten und nutzt einen API-Schlüssel. Er kann also, was sie können, mit denselben Grenzen. Wie Schlüssel funktionieren, steht unter [KI-Assistenten anbinden](https://blitz.cloud/de/docs/ai-assistants/).

## Installieren

Unter macOS und Linux:

```
curl -fsSL https://blitz.cloud/cli/blitz.js -o ~/.local/bin/blitz
chmod +x ~/.local/bin/blitz
```

`~/.local/bin` muss in deinem `PATH` liegen, jeder andere Ordner darin geht auch. Unter Windows speicherst du die Datei und startest sie mit `node blitz.js`.

## Anmelden

Leg auf der Seite [AI tools](https://dashboard.blitz.cloud/ai) einen Schlüssel an, dann:

```
blitz login
```

Füge den Schlüssel ein, wenn danach gefragt wird. `blitz` probiert ihn einmal aus und speichert ihn in `~/.config/blitz/config.json`, lesbar nur für dich. Auf einem Server oder in CI setzt du stattdessen `BLITZ_API_KEY`. `blitz logout` entfernt den gespeicherten Schlüssel von diesem Rechner. Damit er nirgends mehr funktioniert, widerrufst du ihn auf der Seite AI tools.

## Befehle

```
blitz apps                                 deine Apps, ihr Zustand und ihre Adresse
blitz app blog                             alles über eine App
blitz deploy store uptime-kuma --address status
blitz deploy image nginx --tag 1.29 --port 8080 --address web
blitz deploy github lena/blog --branch main --address blog
blitz rebuild blog                         neu bauen aus dem neuesten Commit
blitz builds blog                          ihre Builds und warum einer scheiterte
blitz logs blog --lines 200                die letzten Zeilen, die sie ausgab
blitz logs blog --previous                 was sie vor dem letzten Neustart ausgab
blitz run blog -- ls -la /data             einen Befehl in der App ausführen
blitz restart blog
blitz pause blog
blitz resume blog
blitz env blog                             ihre Einstellungen, Werte verborgen
blitz env set blog SMTP_HOST=mail.example.com
blitz env unset blog SMTP_HOST
blitz usage                                dein Tarif und wie viel davon belegt ist
blitz status                               ob blitz.cloud selbst ein Problem hat
```

Eine App nennst du beim Namen, bei ihrer Adresse oder bei ihrer ID. `blitz help` zeigt alle Befehle und Optionen.

Neustart, Pause, `run` und `env unset` fragen nach, bevor sie etwas tun. Mit `--yes` entfällt die Frage, etwa in Skripten. `--json` gibt die Antwort des Servers als JSON aus, zum Beispiel für `jq`.

Alles, was die Seite AI tools aufführt, geht auch: `blitz tools` zeigt die Werkzeuge, und `blitz call` ruft eines mit JSON-Argumenten auf, zum Beispiel für Datenbanken:

```
blitz call dbs_list
blitz call dbs_create '{"engine": "postgresql", "name": "blog-db"}'
```

## Gut zu wissen

- Jede Änderung durch `blitz` steht im Verlauf deines Kontos, mit dem Namen des Schlüssels.
- Ein abgelehnter Befehl sagt in einem Satz, warum, und endet mit Code 1. Ein Skript kann dort anhalten.
- Einen Live-Stream der Logs gibt es noch nicht. `blitz logs` zeigt die letzten Zeilen, bis zu 500.
- `blitz run` schickt jedes Wort nach `--` genau so an die App, wie du es eingegeben hast. Für eine Pipe oder alles, was eine Shell als ein Stück lesen soll, setzt du Anführungszeichen darum: `blitz run blog -- sh -c 'ls | wc -l'`.
- Ein Lauf bekommt keine Eingabe mehr, nachdem er gestartet ist, hört nach 60 Sekunden auf zuzuhören, behält bis zu 64 KB Ausgabe und erlaubt 20 Befehle pro Minute. Ein Image ohne `sh` kann keinen ausführen. Der Befehlstext bleibt in deinem Verlauf, Passwörter maskiert.