A migration involves moving your data from one GitHub Enterprise appliance to another; an upgrade involves updating the software on an appliance without moving any of your data.

For information on moving repositories between GitHub.com and GitHub Enterprise, see "Moving a repository from GitHub.com to GitHub Enterprise."

GitHub Enterprise does not support merging—or migrating—multiple appliances into one.

Migrations

You can migrate data from one appliance to another one that is running the same or a newer version of the GitHub Enterprise software.

Reasons to migrate

  • Transitioning from a 32-bit appliance to a 64-bit appliance
  • Testing a new version of GitHub Enterprise before deploying it to production

Prerequisites

  • Two GitHub Enterprise appliances
  • An intermediate server to store backups on

Procedure

The following steps provide an overview but are no substitute for reading "Migrating GitHub Enterprise."

  1. Set up a new appliance.
  2. Enable maintenance mode on your production appliance.
  3. Back up the data on your production appliance.
  4. Restore the data on your new appliance.
  5. Run database migrations on your new appliance.

Upgrades

You can upgrade the software on an existing GitHub Enterprise appliance without moving any of your data. This will involve some downtime because you must enable maintenance mode on your appliance during the upgrade.

Reasons to upgrade

  • Security updates
  • Stability improvements
  • New features

Prerequisites

  • A GitHub Enterprise appliance
  • A new software package (GHP) file

Procedure

The following steps provide an overview but are no substitute for reading "Upgrading to the latest release."

  1. Enable maintenance mode on your appliance.
  2. Upload the new software package to your appliance.
  3. Wait for the configuration run to complete.
  4. Disable maintenance mode on your appliance.