# Déployer depuis GitHub

Source : https://webgune.cloud/oc-oc/docs/deployer-github · Mis à jour le 2026-10-27

# Déployer depuis GitHub

C'est le chemin le plus direct : connectez un dépôt, Webgune détecte le framework et construit l'image à votre place via le **builder auto**.

## Étapes

1. Dans votre projet, **+ Nouveau service → GitHub**.
2. Sélectionnez le dépôt dans la liste (les dépôts d'organisation nécessitent d'avoir accordé l'accès, voir [Créer un compte](/docs/creer-un-compte)).
3. Choisissez la branche à suivre (`main` par défaut).
4. Renseignez le **port** sur lequel votre application écoute (3000 par défaut).
5. Cliquez sur **Créer le service**.

Le premier build démarre aussitôt. Suivez sa progression dans l'onglet **Déploiements**, logs compris.

## Détection automatique du framework

Le builder auto reconnaît la plupart des stacks courantes sans configuration :

| Stack | Détecté via |
|-------|-------------|
| Next.js, Nuxt, Remix, Astro | fichier de config du framework |
| React / Vue / Svelte (Vite) | `vite.config.*` |
| Node.js (Express, Fastify…) | `package.json` + script `start` |
| Python (FastAPI, Django…) | `requirements.txt`, `pyproject.toml` |
| Go | `go.mod` |
| PHP (Laravel…) | `composer.json` |

Le détail par stack est couvert dans la section [Applications Web](/docs/applications-web).

> **Next.js en mode standalone** : si `next.config.ts` définit `output: 'standalone'`, Webgune adapte automatiquement la commande de démarrage pour utiliser `node server.js` plutôt que `next start`.

## Variables d'environnement et redéploiement

Ajoutez vos variables dans l'onglet **Variables** avant ou après le premier déploiement. Le service redémarre automatiquement à chaque modification. Deux actions sont disponibles à tout moment :

- **Redéployer** : reconstruit depuis le dernier commit de la branche suivie.
- **Rebuild sans cache** : repart de zéro, utile si le cache de build a capturé une dépendance périmée.