We recommend setting a hostname for your appliance instead of using a hard-coded IP address.
If you configure a hostname instead of a hard-coded IP address, you will be able to change the physical hardware that your GitHub Enterprise instance runs on without affecting users or client software.
We don't officially support changing the hostname for your GitHub Enterprise instance after you configure it during initial setup.
To ensure that browsers will properly resolve your hostname, it should include a period (
.) and be made up of only lowercase letters. For more information, see Section 4.3.2 of the HTTP RFC.
Note: If you change the hostname of your GitHub Enterprise instance, images and other assets that use absolute URLs, such as embedded issues, will not load. For a basic server rename, we recommend keeping the old hostname as a CNAME on the SSL certificate to ensure assets continue to load from the old hostname.
In the upper-right corner of any page, click .
In the left sidebar, click Management Console.
In the left sidebar, click Hostname.
Type the hostname you'd like to set for your GitHub Enterprise instance.
- To test the DNS and SSL settings for the new hostname, click Test domain settings.
If you don't receive a green checkmark next to all entries, review your configuration for the setting that failed. For more information, see "Configuring DNS nameservers."
Under the left sidebar, click Save settings.
After you configure a hostname, we recommend that you enable subdomain isolation for your GitHub Enterprise instance. For more information, see "Enabling subdomain isolation."