Skip to main content

Configuring the hostname for your instance

You can provide reliable access to sua instância do 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 sua instância do 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 sua instância do GitHub Enterprise Server runs on without affecting users or client software.

The hostname setting in the Console de Gerenciamento 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 Console de Gerenciamento. 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 sua instância do 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. Em uma conta administrativa no GitHub Enterprise Server, no canto superior direito de qualquer página, clique em .

  2. Se você ainda não estiver na página "Administração do site", no canto superior esquerdo, clique em Administração do site.

  3. Na barra lateral " Administrador do site", clique em Console de Gerenciamento .

  4. Na barra lateral Configurações, clique em Nome de host.

  5. Under "Hostname", type the hostname you'd like to set for sua instância do GitHub Enterprise Server.

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

  7. Se você não receber uma marca de seleção verde ao lado de todas as entradas, reveja a sua configuração para a configuração que falhou. Para obter mais informações, confira "Configuring DNS nameservers".

  8. Na barra lateral "Configurações", clique em Salvar configurações.

    Observação: se você salvar as configurações no Console de Gerenciamento, isso reiniciará os serviços do sistema, o que poderá resultar em tempo de inatividade visível pelo usuário.

  9. Aguarde a conclusão da execução de suas configurações.

To help mitigate various cross-site scripting vulnerabilities, we recommend that you enable subdomain isolation for sua instância do 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 sua instância do 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."

Aviso: não altere o nome do host do GitHub Enterprise Server após a configuração inicial. Alterar o nome do host causará comportamento inesperado, até e incluindo falhas de instância e invalidação das chaves de segurança dos usuários. Se você alterou o nome do host da instância e está enfrentando problemas, entre em contato com Suporte do GitHub Enterprise ou Suporte do GitHub Premium.