Gitea : cloner un dépôt en HTTPS ou SSH

Gitea propose deux protocoles de clonage : HTTPS avec authentification par jeton et SSH avec clé publique.

Prérequis

• Un compte sur git.exemple.fr.
• Git installé (git --version).

1. Cloner en HTTPS

Récupérer l’URL via le bouton Code → onglet HTTPS du dépôt :

git clone https://git.exemple.fr/equipe/projet.git

À l’invite, saisir le nom d’utilisateur et un jeton d’accès personnel comme mot de passe.

2. Générer un jeton d’accès

Profil → Paramètres → Applications → Générer un nouveau jeton. Cocher la portée repo. Copier le jeton (affiché une seule fois).

3. Mémoriser le jeton

git config --global credential.helper store

Le jeton est conservé après la première saisie.

4. Cloner en SSH

Récupérer l’URL via le bouton Code → onglet SSH :

git clone git@git.exemple.fr:equipe/projet.git

Le clonage SSH exige une clé publique enregistrée (voir l’article dédié aux clés SSH).

Vérification

cd projet
git remote -v

La sortie affiche l’URL origin en HTTPS ou SSH.

Dépannage

• « Authentication failed » en HTTPS : utiliser un jeton, pas le mot de passe du compte.
• « Permission denied (publickey) » en SSH : aucune clé enregistrée ou non chargée (ssh-add -l).
• « SSL certificate problem » : certificat non reconnu ; installer l’autorité ou utiliser GIT_SSL_NO_VERIFY=1 en lab uniquement.
• Clone lent : préférer SSH si HTTPS passe par un proxy.