# Webgune CLI

Source : https://webgune.cloud/de-de/docs/cli · Mis à jour le 2026-10-27

# Webgune CLI

Das offizielle CLI `webgune` ermöglicht es Ihnen, Ihre Projekte, Dienste, Deployments und Rechnungen direkt vom Terminal aus zu verwalten.

## Installation

```bash
bun add -g webgune
# oder
npm install -g webgune
```

Node.js 18 oder höher ist erforderlich.

## Authentifizierung

```bash
webgune login
```

Ohne Option öffnet `webgune login` Ihren Browser, wie die VS Code-Erweiterung, um das CLI für Ihr angemeldetes Konto zu autorisieren. Ein **API-Schlüssel** (Präfix `wgk_`) wird automatisch mit den erforderlichen Scopes erstellt (`projects`, `services`, `domains:read`, `billing`) und über einen lokalen Server (`127.0.0.1`) an das CLI zurückgegeben. Nichts zu kopieren/einzufügen.

Für einen skriptgesteuerten Einsatz (CI, Container ohne Browser), geben Sie direkt einen bestehenden Schlüssel an. Erstellen Sie ihn im Dashboard unter **Einstellungen → API-Schlüssel**:

```bash
webgune login --key wgk_xxxxxxxx
```

Der Schlüssel wird in `~/.webgune/config.json` gespeichert. Sie können auch Umgebungsvariablen verwenden, praktisch in CI:

```bash
export WEBGUNE_API_KEY=wgk_xxxxxxxx
export WEBGUNE_API_URL=https://api.webgune.cloud   # optional
```

## Befehle

### Projekte

```bash
webgune projects list
webgune projects create mein-projekt
webgune projects delete <id>
```

### Dienste

```bash
webgune services list                    # alle Ihre Dienste
webgune services list --project <id>    # gefiltert nach Projekt
webgune services info <id>              # vollständige Details
webgune services logs <id> --tail 500   # Ausführungslogs
webgune services redeploy <id>          # Rebuild + Redeployment
webgune services restart <id>
webgune services stop <id>
webgune services start <id>
```

### Deployments

```bash
webgune services deployments <id>                 # Historie
webgune services rollback <serviceId> <deployId>  # Rollback
```

### Abrechnung

```bash
webgune billing plans                    # Preisübersicht
webgune billing subscription             # Ihre Abonnements (Konto + dedizierte pro Projekt) und der SEPA-Mandatsstatus
webgune billing invoices                 # Ihre Rechnungen
webgune billing cancel                   # Kündigung des Konto-Abonnements (Wirkung am Ende der Periode)
webgune billing cancel --project <id>    # Kündigung eines einem Projekt gewidmeten Abonnements
```

Gemäß den [Allgemeinen Geschäftsbedingungen](/tos) tritt die Kündigung eines Tarifs **am Ende des bereits bezahlten Zeitraums** in Kraft. Ihre Dienste bleiben bis dahin aktiv. Die Kündigung wird abgelehnt, wenn eine Rechnung zur Zahlung aussteht.

### Domains

```bash
webgune domains list
```

## JSON-Ausgabe

Alle Listing-Befehle akzeptieren `--json` für eine rohe, skriptfähige Ausgabe:

```bash
webgune services list --json | jq '.[].name'
```

## Siehe auch

- [MCP-Server](/docs/mcp): steuern Sie webgune von Claude oder jedem MCP-Client aus.
- [API-Referenz](/docs/reference-api): die zugrunde liegende HTTP-API.