Que signifie "Permission denied (publickey)" ?

Cela signifie que la poignée de main SSH avec le serveur a échoué : GitHub (ou GitLab, Bitbucket) n'a reçu aucune clé privée correspondant à une clé publique enregistrée sur ton compte. Git n'a même pas pu vérifier tes droits sur le dépôt.

J'ai ajouté ma clé sur GitHub mais ça échoue encore. Pourquoi ?

Trois causes fréquentes : tu as collé la clé privée au lieu du fichier .pub, la clé n'est pas chargée dans ton agent SSH (lance "ssh-add ~/.ssh/id_ed25519"), ou SSH propose une autre clé. Lance "ssh -T git@github.com -v" pour voir quelles clés sont essayées.

Est-ce risqué de partager mon fichier .pub ?

Non. Le fichier .pub est la moitié publique de la paire de clés et il est fait pour être partagé. Ne partage jamais la clé privée (le fichier sans .pub), et protège-la avec une passphrase si la machine est partagée.

Télécharger

git@github.com: Permission denied (publickey)

Cette erreur signifie que GitHub a refusé ta connexion SSH parce qu'il n'a pas pu t'authentifier avec une clé. Ton code est en sécurité. Il te suffit de configurer une clé SSH une fois, et ça prend cinq minutes.

Apprendre Git en pratiquant Voir la solution

gitquest — enquête

Explication de l'erreur

Ce que cette erreur signifie

Quand tu utilises une URL SSH comme git@github.com:team/project.git, Git s'authentifie avec une paire de clés SSH au lieu d'un mot de passe. GitHub vérifie si ta machine propose une clé privée correspondant à une clé publique enregistrée sur ton compte. Si aucune clé ne correspond, la connexion est refusée avant même que Git puisse agir.

gitquest terminal : permission refusée

$git clone git@github.com:team/project.git

Cloning into 'project'...

git@github.com: Permission denied (publickey).

fatal: Could not read from remote repository.

Please make sure you have the correct access rights

and the repository exists.

Causes principales

Pourquoi cela se produit

Aucune clé SSH sur cette machine

Un ordinateur neuf ou un nouveau compte utilisateur n'a aucune paire de clés dans ~/.ssh. GitHub n'a rien à comparer, donc chaque connexion SSH est rejetée.

Clé jamais ajoutée sur GitHub

Tu as généré une clé mais tu n'as jamais enregistré la partie publique sur GitHub. La clé existe en local, mais GitHub ne sait pas qu'elle appartient à ton compte.

L'agent ne propose pas la clé

La clé existe et elle est sur GitHub, mais l'agent SSH ne l'a pas chargée, ou SSH propose une autre clé en premier. Fréquent après un redémarrage ou avec plusieurs clés.

Solution étape par étape

Comment corriger

Génère une clé, ajoute-la à l'agent et à GitHub, puis teste. Tu ne le fais qu'une fois par machine.

Générer et charger une clé

Vérifie d'abord si une clé existe. Sinon, crée une clé Ed25519 et ajoute-la à l'agent.

gitquest terminal : créer la clé

# 1. Vérifie si tu as déjà une clé

$ls -al ~/.ssh

# Cherche id_ed25519.pub ou id_rsa.pub

# 2. Sinon, génère-en une

$ssh-keygen -t ed25519 -C "toi@exemple.com"

Your public key has been saved in ~/.ssh/id_ed25519.pub

# 3. Ajoute-la à l'agent SSH

$eval "$(ssh-agent -s)"

$ssh-add ~/.ssh/id_ed25519

Identity added: /Users/toi/.ssh/id_ed25519

Enregistrer sur GitHub et tester

Copie la clé publique sur GitHub, puis vérifie avec ssh -T.

gitquest terminal : ajouter et tester

# 4. Copie la clé PUBLIQUE (fichier .pub)

$cat ~/.ssh/id_ed25519.pub

ssh-ed25519 AAAAC3NzaC1lZDI1... toi@exemple.com

# Colle-la sur GitHub > Settings > SSH and GPG keys > New SSH key

# 5. Teste la connexion

$ssh -T git@github.com

Hi toi! You've successfully authenticated, but GitHub does not provide shell access.

Pas de SSH ? Utilise HTTPS

Si tu ne peux pas utiliser SSH (réseau verrouillé, machine partagée), passe le remote en HTTPS et authentifie-toi avec un personal access token ou un gestionnaire d'identifiants.

gitquest terminal : alternative HTTPS

# Alternative : passer le remote en HTTPS

$git remote set-url origin https://github.com/team/project.git

$git remote -v

origin https://github.com/team/project.git (fetch)

origin https://github.com/team/project.git (push)

# Git s'authentifiera alors avec un token au lieu de SSH

Bonnes pratiques

Comment éviter cette erreur

Une clé par machine

Génère une clé dédiée sur chaque ordinateur que tu utilises et enregistre chacune sur GitHub. Ne copie jamais une clé privée d'une machine à l'autre.

Teste après chaque changement

Après une mise à jour de l'OS, une réinstallation ou une nouvelle clé, lance ssh -T git@github.com avant d'avoir un push urgent à faire.

Passphrase + agent SSH

Protège ta clé privée avec une passphrase et laisse l'agent SSH (ou le trousseau de ton OS) la retenir. La sécurité sans la retaper à chaque fois.

Commandes associées

git clone

Copier un dépôt distant en local

git remote

Gérer les URLs des dépôts distants

git push

Envoyer tes commits vers le remote

GitQuest est conçu par Anaïs (nouvelle fenêtre), développeuse web et responsable pédagogique, spécialisée en formations tech et accessibilité numérique.

Questions sur Permission denied (publickey)

Comprendre Git plutôt que mémoriser des solutions

GitQuest t'apprend comment Git et les remotes fonctionnent vraiment à travers des enquêtes pratiques, pour que ce genre d'erreur ne soit plus jamais un mystère.

Commencer à pratiquer