You can increase or change the amount of storage available for Git repositories, databases, search indexes, and other persistent application data.

Warning: The process for allocating new system resources will vary by virtualization platform and resource type, but the first step is always to configure monitoring and alerting of key system resources.

As more users join your GitHub Enterprise instance, you may need to resize your storage volume accordingly.

Note: You'll need to place your instance in maintenance mode before resizing the user storage volume.

Platform Information on resizing storage
Amazon AWS

Based on your seat count, we recommend this hardware configuration:

Seats vCPUs Memory Attached Storage Root Storage
10-500 2 16 GB 100 GB 200 GB
500-3000 4 32 GB 250 GB 200 GB
3000-5000 8 64 GB 500 GB 200 GB
5000-8000 12 72 GB 750 GB 200 GB
8000-10000+ 16 128 GB 1000 GB 200 GB

These are minimum recommendations. More resources may be required depending on your usage, such as user activity and selected integrations.

Increasing the data partition size

  1. Use your virtualization platform's tools to allocate additional physical storage to the user volume.
  2. As a site admin, SSH into your GitHub Enterprise instance:

    ssh -p 122 admin@hostname
  3. Place the appliance in maintenance mode.

  4. To detect new storage allocation, reboot the appliance.
  5. Use the ghe-storage-extend command-line utility to expand the /data filesystem:

Increasing the root partition size

  1. Provision and install GitHub Enterprise as a new appliance with a larger root disk and using the same version as your current appliance.
  2. Shutdown the current appliance.
  3. Using your virtualization platform's tools, detach the data disk from the current appliance.
  4. Attach the data disk to the new appliance with the larger root disk.