Home ci 17. security: Deployment Retention

17. security: Deployment Retention

Last updated on Aug 05, 2025

Deployment Retention

Deployment retention refers to the configured policies that determine how long different types of deployments are kept before they are automatically deleted. These retention policies allow you to control how long your deployment data is stored, providing enhanced protection, compliance support, and efficient storage management.

Epycbyte provides unlimited deployment retention for all deployments, regardless of the plan you are using. You can configure retention durations for the following deployment states:

  • Canceled deployments
  • Errored deployments
  • Preview deployments
  • Production deployments

For example, if you set a 60-day retention period for a production deployment created on 01/01/2024 and later replace it with a newer deployment, the origin deployment will expire on 03/01/2024. Users accessing it will see a 410 status code until 03/31/2024, when all associated resources are permanently removed.

Once a retention policy is enabled, deployments within the retention period will start to be automatically marked for deletion within a few days of enabling the policy.

Setting a Deployment Retention Policy

To configure a retention policy:

  1. Navigate to the Settings tab of your project.
  2. Select Security on the side panel.
  3. Scroll down to the Deployment Retention Policy section.
  4. Select the dropdown menu with the appropriate duration.
  5. Save the new retention policy for your project.

Viewing Deployment Retention Policy

You can view your deployment retention policy using the Epycbyte CLI with the following command:

terminal epycbyte list [project-name] [--policy errored = 6 m]

Restoring a Deleted Deployment

If a deployment is marked for deletion accidentally or as part of the retention policy, it can be restored within a 30-day recovery period. To restore a deleted deployment:

  1. Navigate to the Settings tab of your project.
  2. Select Security on the side panel.
  3. Scroll down to the Recently Deleted section.
  4. Find the deployment that needs to be restored and click on the dropdown menu item Restore.
  5. Complete the modal.

Note: For advanced deployment restoration support, contact us to discuss Enterprise options. Contact Sales for more details.

Table of Contents

  1. Deployment Retention is available on all plans.
  2. Deployment retention refers to configured policies that determine how long deployments are kept before automatic deletion.
  3. These policies provide:
    • Enhanced protection
    • Compliance support
    • Efficient storage management
  4. Epycbyte provides unlimited deployment retention for all deployments.

How-to

  • Learn how deployment retention policies affect a deployment's lifecycle.
  • Understand the steps to set, view, and restore deleted deployments.

Troubleshooting

  • If you encounter issues with deployment retention, refer to the troubleshooting guide.

Last updated on October 11, 2024.