Skip to main content

This version of GitHub Enterprise Server was discontinued on 2023-09-25. No patch releases will be made, even for critical security issues. For better performance, improved security, and new features, upgrade to the latest version of GitHub Enterprise Server. For help with the upgrade, contact GitHub Enterprise support.

Configuring network settings

Configure GitHub Enterprise Server with the DNS nameservers and hostname required in your network. You can also configure a proxy server or firewall rules. You must allow access to certain ports for administrative and user purposes.

Configuring the IP address using the virtual machine console

By default, GitHub Enterprise Server retrieves network settings via the dynamic host configuration protocol (DHCP). If your platform supports it, or if DHCP is unavailable, you can also configure the network settings using the virtual machine console.

Configuring DNS nameservers

GitHub Enterprise Server uses the dynamic host configuration protocol (DHCP) for DNS settings when DHCP leases provide nameservers. If nameservers are not provided by a dynamic host configuration protocol (DHCP) lease, or if you need to use specific DNS settings, you can specify the nameservers manually.

Configuring the hostname for your instance

You can provide reliable access to your GitHub Enterprise Server instance by assigning a hostname that's accessible over your network.

Changing the hostname for your instance

If you want to change the hostname for an existing GitHub Enterprise Server instance, you must restore the settings and data to a new instance.

Validating your domain settings

Ensure that your domain settings are properly configured before booting up your GitHub Enterprise Server instance for the first time.

Configuring an outbound web proxy server

A proxy server provides an additional level of security for your GitHub Enterprise Server instance.

Configuring built-in firewall rules

You can view default firewall rules and customize rules for your GitHub Enterprise Server instance.

Network ports

Open network ports selectively based on the network services you need to expose for administrators, end users, and email support.

Using GitHub Enterprise Server with a load balancer

Use a load balancer in front of a single GitHub Enterprise Server instance or a pair of instances in a High Availability configuration.

Configuring time synchronization

GitHub Enterprise Server automatically synchronizes its clock by connecting to NTP servers. You can set the NTP servers that are used to synchronize the clock, or you can use the default NTP servers.