Renommer un référentiel

Vous pouvez renommer un dépôt si vous êtes propriétaire d’une organisation ou disposez d’autorisations d’administrateur pour le dépôt.

Lorsque vous renommez un référentiel, toutes les informations existantes, à l’exception des URL du site du projet, sont automatiquement redirigées vers le nouveau nom, notamment :

  • Problèmes
  • Wikis
  • Étoiles
  • Abonnés

Pour plus d’informations sur les sites de projet, consultez À propos de GitHub Pages.

En plus de rediriger le trafic web, toutes les opérations git clone, git fetch et git push ciblant l’emplacement précédent continuent de fonctionner comme si elles étaient effectuées sur le nouvel emplacement. Toutefois, pour éviter toute confusion, nous vous recommandons vivement de mettre à jour tous les clones locaux existants de façon à ce qu’ils pointent vers la nouvelle URL du référentiel. Pour ce faire, vous pouvez utiliser git remote sur la ligne de commande :

git remote set-url origin NEW_URL

Pour plus d’informations, consultez « Création de dépôt distants ».

Si vous comptez renommer un référentiel associé à un site GitHub Pages, nous vous recommandons d’utiliser un domaine personnalisé pour votre site. Cela garantit que l’URL du site n’est pas affectée par le changement de nom du référentiel. Pour plus d’informations, consultez « À propos des domaines personnalisés et des pages GitHub ».

Note

GitHub ne redirigera pas les appels vers une action hébergée par un référentiel renommé. Tout workflow qui utilise cette action échoue avec l’erreur repository not found. Créez plutôt un référentiel et une action avec le nouveau nom et archivez l’ancien référentiel. Pour plus d’informations, consultez « Archivage de référentiels ».

Warning

Si vous créez un référentiel sous votre compte à l’avenir, ne réutilisez pas le nom d’origine du référentiel renommé. Si vous le faites, les redirections vers le dépôt renommé ne fonctionneront plus.

  1. Sur GitHub, accédez à la page principale du référentiel.

  2. Sous le nom de votre dépôt, cliquez sur Paramètres. Si vous ne voyez pas l’onglet « Paramètres », sélectionnez le menu déroulant , puis cliquez sur Paramètres.

    Capture d’écran d’un en-tête de dépôt montrant les onglets. L’onglet « Paramètres » est mis en évidence avec un encadré orange foncé.

  3. Dans le champ Nom du dépôt, tapez le nouveau nom de votre dépôt.

  4. Cliquez sur Renommer.