Archive & Auto-delete automatically manages inactive environments through a two-stage lifecycle: archival after 7 days of inactivity, then auto-deletion based on configurable policies.

How it works

  1. Automatic archiving: After 7 days of inactivity (fixed)
  2. Configurable auto-deletion: After 1, 2, or 4 weeks, or never

Environment lifecycle

Automatic archiving

Environments are archived when stopped for 7 consecutive days (fixed period).

Archived environments:

  • Move to a separate archive view
  • Can be unarchived or deleted

Accessing archived environments

The Archive button in the sidebar shows a badge when you have archived environments

Click the Archive button in your sidebar to view archived environments. The button shows a badge when environments are archived. Press Escape to return to the main view.

The Archive view shows all archived environments

Managing archived environments

Archive view organization

Environments are grouped by when they were archived:

  • 1 week ago
  • 2 weeks ago
  • 1+ month ago

Available actions

Hover over an archived environment to see available actions

Unarchive an environment

Hover over the environment and click the restore button to unarchive. The environment returns to your main list immediately.

Delete an environment

Hover over the environment and click the delete button to delete. Confirm in the dialog.

Deleting an environment permanently removes all content, including code, configurations, and data. This action cannot be undone.

Delete all archived environments

The Delete All button appears at the bottom of the archive view

Click the Delete All button at the bottom and confirm to delete all archived environments.

Auto-delete configuration

Setting your preference

Configure your auto-delete preference using the dropdown in the archive view

Select your auto-delete preference from the dropdown:

  • After 1 week: 14 days total from last use
  • After 2 weeks: 21 days total from last use
  • After 4 weeks: 35 days total from last use
  • Never

Organization policies

Organization policies override user preferences when more restrictive. Disabled options in the dropdown indicate policy restrictions.

Best practices

  • Before archiving: Commit and push important work
  • Team coordination: Align deletion timelines with your workflow needs

Frequently asked questions

When are environments archived? After 7 days of inactivity (fixed period).

Can I recover deleted environments? No, deletion is permanent. Only archived environments can be recovered.

Why are some auto-delete options disabled? Your organization policy may enforce maximum retention periods.

Do running environments get archived? No, only stopped environments are archived.

Troubleshooting

Can’t change auto-delete preference: Check for organization policy restrictions.