This version of GitHub Enterprise Server was discontinued on 2024-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.

Removing a high availability replica

You can stop replication to a GitHub Enterprise Server replica temporarily, or permanently remove replication.

In this article

Stopping replication temporarily

  1. If necessary, stop a geo-replication replica from serving user traffic by removing the Geo DNS entries for the replica.

  2. On the replica where you wish to temporarily stop replication, run ghe-repl-stop.

    ghe-repl-stop

  3. To start replication again, run ghe-repl-start.

    ghe-repl-start

Removing replication permanently

  1. If necessary, stop a geo-replication replica from serving user traffic by removing the Geo DNS entries for the replica.

  2. On the replica you wish to remove replication from, run ghe-repl-stop.

    ghe-repl-stop

  3. On the replica, to tear down the replication state, run ghe-repl-teardown.

    ghe-repl-teardown

Note

If you have GitHub Actions enabled, you should decommission the former replica server or update its GitHub Actions configuration to use different external storage. For more information, see High availability for GitHub Actions.