Configuring the hostname for your instance

About the hostname for GitHub Enterprise Server

To provide reliable access to Ihre GitHub Enterprise Server-Instance 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 Ihre GitHub Enterprise Server-Instance runs on without affecting users or client software.

The hostname setting in the Verwaltungskonsole 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 Verwaltungskonsole. 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 Ihre GitHub Enterprise Server-Instance. For more information, see "Subdomain-Isolation aktivieren."

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. Klicke in einem Verwaltungskonto auf GitHub Enterprise Server und dann in der rechten oberen Ecke einer beliebigen Seite auf „“.

2. Wenn du dich nicht bereits auf der Seite „Websiteadministrator“ befindest, klicke in der oberen linken Ecke auf Websiteadministrator.

3. Wähle auf der Randleiste „ Websiteadministrator“ die Option Verwaltungskonsole aus.

4. Klicke auf der Randleiste unter „Einstellungen“ auf Hostname.

5. Under "Hostname", type the hostname you'd like to set for Ihre GitHub Enterprise Server-Instance.

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

7. Wenn nicht neben allen Einträgen ein grünes Häkchen angezeigt wird, solltest Du Deine Konfiguration auf die fehlgeschlagene Einstellung überprüfen. Weitere Informationen findest du unter DNS-Nameserver konfigurieren.

8. Klicke auf der Randleiste unter „Einstellungen“ auf Einstellungen speichern.

   Hinweis: Durch das Speichern von Einstellungen in der Verwaltungskonsole werden Systemdienste neu gestartet, was zu einer für den Benutzer feststellbaren Downtime führen könnte.

9. Warten Sie auf den Abschluss der Konfigurationsausführung.

To help mitigate various cross-site scripting vulnerabilities, we recommend that you enable subdomain isolation for Ihre GitHub Enterprise Server-Instance after you configure a hostname. For more information, see "Subdomain-Isolation aktivieren."

Changing the hostname

If you need to change the hostname for Ihre GitHub Enterprise Server-Instance, 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."