Configuring the hostname for your instance

About the hostname for GitHub Enterprise Server

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

The hostname setting in the Consola de administración 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 Consola de administración. 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 tu instancia de 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. Desde una cuenta administrativa de GitHub Enterprise Server, en la esquina superior derecha de cualquier página, haga clic en .

2. Si todavía no está en la página "Administrador del sitio", en la esquina superior izquierda, haga clic en Administrador del sitio.

3. En la barra lateral " Administrador del sitio", haz clic en Consola de administración .

4. En la barra lateral Settings, haga clic en Hostname.

5. Under "Hostname", type the hostname you'd like to set for tu instancia de GitHub Enterprise Server.

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

7. Si no ves una tilde verde al costado de todas las entradas, revisa tu configuración para los elementos de configuración que hayan fallado. Para obtener más información, vea «Configuring DNS nameservers».

8. En la barra lateral "Configuración" , haga clic en Guardar configuración.

   Nota: Al guardar la configuración en la Consola de administración se restablecen los servicios de sistema, lo que podría generar un tiempo de inactividad visible para el usuario.

9. Espera que se complete la fase de configuración.

To help mitigate various cross-site scripting vulnerabilities, we recommend that you enable subdomain isolation for tu instancia de 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 tu instancia de 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."