Configuring the hostname for your instance

About the hostname for GitHub Enterprise Server

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

The hostname setting in the 관리 콘솔 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 관리 콘솔. 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 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. 페이지의 오른쪽 상단에 있는 GitHub Enterprise Server의 관리 계정에서 을 클릭합니다.

2. “Site admin”(사이트 관리자) 페이지에 아직 없는 경우 왼쪽 상단에서 Site admin(사이트 관리자)을 클릭합니다.

3. " 사이트 관리자" 사이드바에서 관리 콘솔 을 클릭합니다.

4. 설정 사이드바의 호스트 이름을 클릭합니다.

5. Under "Hostname", type the hostname you'd like to set for GitHub Enterprise Server 인스턴스.

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

7. 모든 항목 옆에 녹색 확인 표시가 표시되지 않으면 실패한 설정에 대한 구성을 검토합니다. 자세한 내용은 "Configuring DNS nameservers"을(를) 참조하세요.

8. "설정" 사이드바에서 설정 저장을 클릭합니다.

   참고: 관리 콘솔에 설정을 저장하면 시스템 서비스가 다시 시작되어 사용자에게 표시되는 가동 중지 시간이 발생할 수 있습니다.

9. 구성 실행이 완료될 때까지 기다립니다.

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