1
0
mirror of synced 2025-12-19 18:10:59 -05:00
Files
Sophie 0f3cc6e990 GitHub Enterprise Server 3.17 release candidate (#55411)
Co-authored-by: docs-bot <77750099+docs-bot@users.noreply.github.com>
Co-authored-by: Isaac Brown <101839405+isaacmbrown@users.noreply.github.com>
Co-authored-by: Pallavi <96553709+pallsama@users.noreply.github.com>
Co-authored-by: Stephanie Sabota <80356791+steph-sabotasan@users.noreply.github.com>
Co-authored-by: Casey Tucker <dctucker@github.com>
Co-authored-by: Hao Jiang <45571951+jianghao0718@users.noreply.github.com>
Co-authored-by: Felicity Chapman <felicitymay@github.com>
Co-authored-by: mc <42146119+mchammer01@users.noreply.github.com>
2025-05-15 16:32:44 +00:00

1.9 KiB

title, shortTitle, intro, versions, type, topics
title shortTitle intro versions type topics
Restoring with GitHub Actions enabled Restore with Actions Learn how to prepare for and restore backups when {% data variables.product.prodname_actions %} is enabled with external blob storage.
ghes
>= 3.17
how_to
Backups

[!IMPORTANT] Data stored in your configured external storage for {% data variables.product.prodname_actions %}—such as logs, artifacts, and other blobs—is not included in {% data variables.product.prodname_enterprise_backup_service %} snapshots. You must back up this data separately using your storage provider's tools and best practices.

When restoring an instance with {% data variables.product.prodname_actions %} enabled, follow these steps to preserve compatibility with existing Actions data:

  1. Provision the target instance.

  2. Preconfigure Actions storage:

    1. In the {% data variables.enterprise.management_console %}, enable {% data variables.product.prodname_actions %}.

    2. Enter the exact same external storage provider and credentials used in the original instance.

    3. Click Save.

      This step ensures the restored Actions metadata correctly references your existing external data.

  3. Enable maintenance mode on the target instance.

  4. Restore the backup:

    1. Run the ghe-restore command as described in Starting the restore operation.
    2. The restoration process includes Actions metadata but assumes external storage is already accessible and configured.
  5. Finalize settings in the {% data variables.enterprise.management_console %}.

  6. Re-register self-hosted runners:

    All runners must be re-registered with the restored instance, as previous registration tokens are invalid after a restore.

For more information, see AUTOTITLE.