What is GitHub Enterprise?

GitHub Enterprise is the on-premises version of GitHub.com. It makes collaborative coding possible and enjoyable for large-scale enterprise software development teams. A full list of specs and features are detailed on our data sheet.

How is GitHub Enterprise different from GitHub.com?

GitHub Enterprise includes the same great set of features as GitHub.com but packaged for running on your organization's local network. All repository data is stored on machines that you control, and access is integrated with your organization's authentication system (LDAP, CAS). Use GitHub Enterprise when you need complete control over repository and project information.

Can I evaluate GitHub Enterprise within my organization before purchasing?

Yes. 45-day evaluation licenses are available and may be upgraded to full licenses at any time during the trial period. To get started, submit a trial license request. We'll contact you shortly after with information on downloading the software and installing trial license keys.

What hardware and software are required?

GitHub Enterprise ships as a virtual machine image that includes all software required to get up and running. The only additional software required is a compatible virtual machine environment.

The following minimal hardware requirements are suggested for production deployments:

  • Processor: Two 3.0 GHz CPU cores (or virtual equivalent)
  • Memory: 8 GB
  • Disk: 75 GB VM root partition
  • Storage: High-performance SAN or locally attached storage
Which Virtual Machine environments are supported?

The software is currently distributed in the industry standard Open Virtualization Format (OVF) only. Environments with official OVF support include:

Please contact us if your environment is not listed above.

Can I use my organization's LDAP directory to manage user access?

Yes. GitHub Enterprise supports user authentication via external LDAP or CAS services. The setup process includes a step for configuring your organization's LDAP/CAS server information.

By default, GitHub Enterprise runs in a self-contained authentication mode with user information stored in the GitHub Enterprise database. LDAP or CAS is not required.

Which LDAP providers are supported?

GitHub Enterprise supports any provider that follows the LDAP specifications. However, some additional authentication features of Enterprise depend on LDAP functionality not implemented by all providers. For this reason we recommend using either Microsoft® Active Directory or OpenLDAP.

How do I control access to Git repositories?

The product includes a number of features that provide complete control over repository access. Each repository may specify the following general access rights for any user:

  • Admin: Full access to the repository, including the ability to control access for other users.
  • Read + Write: Users may push changes into the repository and pull changes from the repository.
  • Read-only: Users may browse the repository via the web interface and use git to fetch changes but may not push into the repository.

In addition, GitHub Enterprise ships with the same collaboration features for Organizations found on github.com. These simplify the process of managing access for teams of users that you define.

Can I use GitHub Enterprise to host projects on the public internet?

No. GitHub Enterprise is designed for collaboration within an organization only. Externally accessible installations must have the Private Mode option enabled. Note that github.com offers free hosting of unlimited public repositories.

How is GitHub Enterprise different from GitHub Firewall Install?

GitHub Enterprise is the latest release of our on-premises product with a re-engineered back end and our new customer dashboard. GitHub Firewall Install differed from it primarily by being installed and run on a server that required manual configuration. GitHub Enterprise is distributed as a Virtual Appliance that runs as a virtual machine under your company's existing virtualization infrastructure. This makes getting started with and maintaining GitHub Enterprise much easier.

Enterprise also incorporates many of the newer improvements made in GitHub.com that were not available in GitHub Firewall Install. Some of the highlights include:

If you are a current FI customer and are interested to learn about the zero-cost migration over to GitHub Enterprise, please contact sales@github.com.

What is a Virtual Appliance?

You can think of a virtual appliance as the equivalent of a network appliance that you might buy, mount in a rack, and plug into your network. The only difference is that it runs as a virtual machine inside of VMware or some other virtualization platform rather than as a physical device you mount in a rack.

This saves time (you can download the appliance and all updates immediately) and space (you just add it to your existing virtualization infrastructure). It also makes managing, backing up, and restoring the appliance easy because you can use your virtualization platform's built-in snapshotting capabilities.

You can learn more about virtual appliances here.

Do you offer training?

Yes. We offer web-based training, in-person training and provide a myriad of free, high-quality educational materials. Please contact the GitHub Training Team for more information.