Skip to main content

Cette version de GitHub Enterprise Server ne sera plus disponible le 2024-06-29. Aucune publication de correctifs n’est effectuée, même pour les problèmes de sécurité critiques. Pour de meilleures performances, une sécurité améliorée et de nouvelles fonctionnalités, effectuez une mise à niveau vers la dernière version de GitHub Enterprise. Pour obtenir de l’aide sur la mise à niveau, contactez le support GitHub Enterprise.

Configuring the hostname for your instance

You can provide reliable access to votre instance GitHub Enterprise Server by assigning a hostname that's accessible over your network.

About the hostname for GitHub Enterprise Server

To provide reliable access to votre instance GitHub Enterprise Server via a known name on the network, you can configure a hostname. If you configure a hostname instead of using a hard-coded IP address, you will be able to change the physical hardware that votre instance GitHub Enterprise Server runs on without affecting users or client software.

The hostname setting in the Management Console should be set to an appropriate fully qualified domain name (FQDN) which is resolvable on the internet or within your internal network. For example, your hostname setting could be github.companyname.com. Web and API requests will automatically redirect to the hostname configured in the Management Console. Note that localhost is not a valid hostname setting.

Hostnames must be less than 63 characters in length per Section 2.3.4 of the Domain Names Specification RFC.

After you configure a hostname, you can enable subdomain isolation to further increase the security of votre instance GitHub Enterprise Server. For more information, see "Enabling subdomain isolation."

GitHub strongly recommends that you do not change the hostname for an existing GitHub Enterprise Server instance. Changing the hostname will cause unexpected behavior, up to and including instance outages. Instead, configure a new instance with the desired hostname, and then restore settings and data from the original instance to the new instance.

For more information on the supported hostname types, see Section 2.1 of the HTTP RFC.

Configuring the hostname

  1. À partir d’un compte d’administration sur GitHub Enterprise Server, cliquez sur en haut à droite de n’importe quelle page.

  2. Si vous ne figurez pas déjà sur la page « Administrateur du site », dans le coin supérieur gauche, cliquez sur Administrateur du site.

  3. Dans la barre latérale «  Administrateur de site », cliquez sur Management Console .

  4. Dans la barre latérale « Paramètres », cliquez sur Nom d’hôte.

  5. Under "Hostname", type the hostname you'd like to set for votre instance GitHub Enterprise Server.

  6. To test the DNS and SSL settings for the new hostname, click Test domain settings.

  7. Si vous ne voyez pas de coche verte à côté de toutes les entrées, vérifiez votre configuration pour le paramètre qui a échoué. Pour plus d’informations, consultez « Configuring DNS nameservers ».

  8. Sous la barre latérale « Paramètres », cliquez sur Enregistrer les paramètres.

    Remarque : l’enregistrement des paramètres dans la Management Console redémarre les services système, ce qui peut entraîner un temps d’arrêt visible pour l’utilisateur.

  9. Attendez la fin de l’exécution de la configuration.

To help mitigate various cross-site scripting vulnerabilities, we recommend that you enable subdomain isolation for votre instance GitHub Enterprise Server after you configure a hostname. For more information, see "Enabling subdomain isolation."

Changing the hostname

If you need to change the hostname for votre instance GitHub Enterprise Server, you must restore a backup of your existing instance to a new instance with the desired hostname. For more information, see "Changing the hostname for your instance."

Avertissement : ne modifiez pas le nom d’hôte de GitHub Enterprise Server après la configuration initiale. La modification du nom d’hôte entraînera un comportement inattendu, pouvant aller jusqu’à des interruptions de l’instance et l’invalidation des clés de sécurité des utilisateurs. Si vous avez modifié le nom d’hôte de votre instance et rencontrez des problèmes, contactez Support GitHub Enterprise ou Support Premium GitHub.