Créer un dépôt Git et faire le premier push¶

Ce guide explique comment créer un dépôt local, le connecter à un dépôt distant (par exemple Forgejo, GitHub, GitLab) et effectuer le premier push.

1. Initialiser le dépôt local¶

Place-toi dans le répertoire de ton projet :

cd ~/chemin/vers/ton/projet

Initialise le dépôt Git :

git init

⚠️ Par défaut, Git crée la branche master. Si tu veux utiliser main :

git branch -M main

2. Configurer ton identité Git¶

Avant de committer, Git a besoin de ton nom et ton email :

git config --global user.name "Ton Nom"
git config --global user.email "ton.email@example.com"

Pour configurer seulement ce dépôt et pas tous les dépôts, supprime --global.

3. Ajouter les fichiers et faire le commit initial¶

Ajoute tous les fichiers de ton projet :

git add .

Fais le commit initial :

git commit -m "Initial commit"

4. Ajouter le dépôt distant¶

Ajoute le dépôt distant (ici Forgejo) :

git remote add origin https://forgejo.exemple.org/utilisateur/nom-depot.git
git remote add origin https://USERNAME:TOKEN@forgejo.exemple.org/utilisateur/nom-depot.git

Vérifie que le dépôt distant est bien configuré :

git remote -v

5. Pousser vers le dépôt distant¶

Si tu as choisi main comme branche :

git push -u origin main

L’option -u permet de définir cette branche comme branche par défaut pour les prochains push/pull.

6. Vérification¶

Tu peux vérifier que tout a été poussé correctement :

git log

Et sur ton dépôt distant, tu devrais voir ton commit initial.

Astuce¶

Pour que tous tes futurs dépôts utilisent main par défaut :

git config --global init.defaultBranch main