# CLI Webgune

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

# CLI Webgune

Le CLI officiel `webgune` vous permet de gérer vos projets, services, déploiements et factures directement depuis le terminal.

## Installation

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

Node.js 18 ou supérieur est requis.

## Authentification

```bash
webgune login
```

Sans option, `webgune login` ouvre votre navigateur, comme l'extension VS Code, pour autoriser le CLI sur votre compte connecté. Une **clé API** (préfixe `wgk_`) est créée automatiquement avec les scopes nécessaires (`projects`, `services`, `domains:read`, `billing`) et renvoyée au CLI via un serveur local (`127.0.0.1`). Rien à copier-coller.

Pour un usage scripté (CI, conteneur sans navigateur), passez une clé existante directement. Créez-la dans le dashboard, **Paramètres → Clés API** :

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

La clé est enregistrée dans `~/.webgune/config.json`. Vous pouvez aussi utiliser des variables d'environnement, utiles en CI :

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

## Commandes

### Projets

```bash
webgune projects list
webgune projects create mon-projet
webgune projects delete <id>
```

### Services

```bash
webgune services list                    # tous vos services
webgune services list --project <id>    # filtrés par projet
webgune services info <id>              # détails complets
webgune services logs <id> --tail 500   # logs d'exécution
webgune services redeploy <id>          # rebuild + redéploiement
webgune services restart <id>
webgune services stop <id>
webgune services start <id>
```

### Déploiements

```bash
webgune services deployments <id>                 # historique
webgune services rollback <serviceId> <deployId>  # retour arrière
```

### Facturation

```bash
webgune billing plans                    # grille tarifaire
webgune billing subscription             # vos abonnements (compte + dédiés par projet) et l'état du mandat SEPA
webgune billing invoices                 # vos factures
webgune billing cancel                   # résiliation de l'abonnement du compte (effet en fin de période)
webgune billing cancel --project <id>    # résiliation d'un abonnement dédié à un projet
```

Conformément aux [Conditions Générales de Services](/tos), la résiliation d'un forfait prend effet **à la fin de la période déjà payée**. Vos services restent actifs jusque-là. La résiliation est refusée si une facture est en attente de paiement.

### Domaines

```bash
webgune domains list
```

## Sortie JSON

Toutes les commandes de listing acceptent `--json` pour une sortie brute exploitable en script :

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

## Voir aussi

- [Serveur MCP](/docs/mcp) : pilotez webgune depuis Claude ou tout client MCP.
- [Référence API](/docs/reference-api) : l'API HTTP sous-jacente.