This version of GitHub Enterprise was discontinued on 2021-09-23. 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. For help with the upgrade, contact GitHub Enterprise support.

Setting up a staging instance

You can use a staging instance to test modifications before they are applied to your GitHub Enterprise Server instance. For example, you could use a staging instance to test new GitHub Enterprise Server updates or to practice importing migration data.

Tip: You may reuse your existing GitHub Enterprise license file as long as the staging instance is not used for production.

To thoroughly test a GitHub Enterprise Server appliance you will need to consider external systems that interact with it. Some factors to consider testing are:

  • Authentication, especially if are using an external authentication provider
  • Integration with an external ticketing system
  • Integration with a continuous integration server
  • External scripts or software that use the GitHub Enterprise Server APIs
  • External SMTP server for email notifications
  1. Perform a backup of your production instance using GitHub Enterprise Server Backup Utilities. For more information, see the "About GitHub Enterprise Server Backup Utilities" section of "Configuring backups on your appliance."
  2. Set up a new instance to act as your staging environment. You can use the same guides for provisioning and installing your staging instance as you did for your production instance. For more information, see "Setting up a GitHub Enterprise Server instance."
  3. Restore your backup onto your staging instance. For more information, see the "Restoring a backup" section of "Configuring backups on your appliance."