---
title: "lizard restart"
description: "lizard restart führt einen Rolling-Restart des aktuellen Builds eines Dienstes ohne Rebuild aus und ist nützlich, um sich von einem Absturz zu erholen."
url: https://lizard.build/de/docs/cli/restart/
updated: 2026-10-21
---

# lizard restart

Rolling-Restart des aktuellen Builds — kein Rebuild.

## Verwendung

```bash
lizard restart [nameOrId] [flags]
```

## Flags

| Flag | Beschreibung |
|------|--------------|
| `-s, --service <name>` | Dienst |
| `-p, --project <id>` | Projektname, Slug oder ID |
| `--detach` | Nach Annahme des Restarts zurückkehren, ohne dessen Status abzufragen |
| `--wait` | Warten, bis der neue Restart-Versuch bereit ist; funktioniert mit `--json` |
| `--timeout <seconds>` | Wartebudget für Bereitschaft mit `--wait`; Standard `120` |
| `--json` | JSON für Skripte zurückgeben |

## Beispiele

### Einen Dienst neu starten

```bash
lizard restart --service api
```

### Zurückkehren, ohne zu warten

```bash
lizard restart --service api --detach
```

### Vor der nächsten Prüfung warten

```bash
lizard --json restart --service api --wait --timeout 120
```

Ohne `--wait` gibt der JSON-Modus nach Annahme des Restarts zurück. Mit `--wait` enthält das Ergebnis `ok`, `status`, `attemptId` und `waitedMs`. Die CLI wartet auf einen neuen Restart-Versuch, daher zählt ein unveränderter Status von vor der Anfrage nicht als Erfolg. Ein fehlgeschlagenes Warten oder ein Timeout liefert einen Exit-Code ungleich null zurück.

Ein pausierter Dienst lehnt einen Restart ab, bis du ihn [fortsetzt](https://lizard.build/de/docs/cli/pause.md).

Bei HTTP-Diensten prüft die CLI zusätzlich die Dienst-Domain zweimal. Worker mit `containerPort=0` verwenden den Bereitschaftsstatus aus dem Backend und benötigen keinen HTTP-Listener, selbst wenn sie eine generierte Domain haben.

```bash
lizard --json restart --service worker --wait --timeout 60
```

Das Timeout gilt für das Warten auf Bereitschaft nach der Restart-Anfrage. Es bricht den Restart nicht ab, und Netzwerkaufrufe können dazu führen, dass der gesamte Befehl länger dauert. Prüfe nach dem Befehl Anwendungsdaten oder einen Health-Endpunkt, wenn dein Workflow mehr als Prozessbereitschaft benötigt.

## Siehe auch

- [lizard redeploy](https://lizard.build/de/docs/cli/redeploy.md) — einen frischen Build auslösen, statt den aktuellen wiederzuverwenden
- [lizard logs](https://lizard.build/de/docs/cli/logs.md) — Logs rund um einen Restart mit `--restart latest` oder `--restart <id>` prüfen
- [Bereitstellungen](https://lizard.build/de/docs/concepts/deployments.md) — Restarts vs. Redeploys und Wiederherstellung nach einem Absturz
