Skip to main content

Changing the hostname for your instance

If you want to change the hostname for an existing GitHub Enterprise Server instance, you must restore the settings and data to a new instance.

About changes to the hostname for GitHub Enterprise Server

If you need to use a new hostname for Ihre GitHub Enterprise Server-Instance, you must back up the existing instance's settings and data, configure a new instance, restore the backup to the new instance, and then adjust your DNS configuration to send traffic to the new instance.

Migration to a new instance requires downtime. The amount of downtime required depends on how much data you need to back up, as well as the speed of the network connection between the backup host and the instances.

In this article, the term "source instance" refers to the instance with the old hostname, and "destination instance" refers to the instance with the new hostname.

Warnung: Ändere den Hostnamen für GitHub Enterprise Server nach der Ersteinrichtung nicht mehr. Das Ändern des Hostnamens wird zu unerwartetem Verhalten führen, bis hin zu Instanzausfällen und der Ungültigkeit der Sicherheitsschlüssel der Benutzer. Wenn Sie den Hostnamen für Ihre Instanz geändert haben und Probleme auftreten, wenden Sie sich an GitHub Enterprise Support oder GitHub Premium-Support.

Migrating to an instance with a new hostname

  1. Configure a destination instance of GitHub Enterprise Server with the new hostname you'd like to use. For more information, see the following documentation.

  2. Inform the instance's users of the scheduled downtime. Optionally, you can create a mandatory message that will appear for all users who sign in. For more information, see "Customizing user messages for your enterprise."

  3. On the source instance, enable maintenance mode. For more information, see "Wartungsmodus aktivieren und planen."

  4. Back up the source instance's data and settings using GitHub Enterprise Server Backup Utilities. For more information, see "Konfigurieren von Sicherungen auf einer Instanz."

  5. Restore the backup to the destination instance with the desired hostname. When you run the ghe-restore utility, use the -c option to overwrite the destination instance's configuration. For more information, see "Konfigurieren von Sicherungen auf einer Instanz."

  6. Finalize configuration of the destination instance. For more information, see "Konfigurieren von GitHub Enterprise."

  7. On the destination instance, enable maintenance mode.

  8. Optionally, while the destination instance is in maintenance mode, validate the instance's configuration and verify that user data is intact. For more information, see "Wartungsmodus aktivieren und planen."

  9. To direct traffic to the destination instance, update the DNS CNAME record with the source instance's hostname to resolve to the IP address of the destination instance.

    Note: Restored user-generated content in the instance's web application will likely contain URLs that reference the source instance's old hostname. Optionally, to ensure that these links continue to resolve to the destination instance, you can configure a redirect using DNS. In addition to the CNAME record that resolves to the new instance's hostname, configure a second DNS CNAME record that directs traffic from the original hostname to the new hostname. For more information, see the documentation for your DNS provider.

  10. On the destination instance, disable maintenance mode.