Skip to main content

Configuring a hostname

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 Server instance runs on without affecting users or client software.

The hostname setting in the [Management Console] 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 [Management Console]. 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 your GitHub Enterprise Server instance. For more information, see "Enabling subdomain isolation."

For more information on the supported hostname types, see Section 2.1 of the HTTP RFC.

警告: 初期セットアップ後に GitHub Enterprise Server のホスト名を変更しないでください。 ホスト名を変更すると、インスタンスの停止に及ぶ予想外の動作が生じます。

  1. GitHub Enterprise Server の管理アカウントから、任意のページの右上隅の をクリックします。

    サイト管理者設定にアクセスするための宇宙船アイコンのスクリーンショット

  2. [サイト管理者] ページにまだ表示されていない場合は、左上隅の [サイト管理者] をクリックします。

    [サイト管理者] リンクのスクリーンショット

  3. 左側のサイドバーで、 [Management Console] をクリックします。 左側のサイドバーの [[Management Console]] タブ

  4. 左側のサイドバーで、 [ホスト名] をクリックします。 設定サイドバーの [ホスト名] タブ

  5. Type the hostname you'd like to set for your GitHub Enterprise Server instance. Field for setting a hostname

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

  7. すべてのエントリの隣に緑のチェックマークが付かない場合は、失敗した設定をレビューしてください。 詳細については、「DNS ネームサーバーの構成」を参照してください。 DNS および SSL 構成の状態を示す表

  8. 左側のサイドバーで、 [設定の保存] をクリックします。

    [Management Console] の [設定の保存] ボタンのスクリーンショット

    注: [Management Console] に設定を保存すると、システム サービスが再起動され、ユーザーに表示されるダウンタイムが発生する可能性があります。

  9. 設定の実行が完了するのを待ってください。

    インスタンスの設定

To help mitigate various cross-site scripting vulnerabilities, we recommend that you enable subdomain isolation for your GitHub Enterprise Server instance after you configure a hostname. For more information, see "Enabling subdomain isolation."