Skip to Content
How-to guidesArchive and restore a space

Archive and restore a space

Tidy your space list without losing work. Archive a space when a feature ships or an experiment ends: it leaves your active list, stops using compute, frees its disk, and keeps a backup of its workspace in your org’s storage. If you need it again next week, restore it and pick up where you left off.

Before you start

  • Role: the space’s owner.
  • Available when your administrator enables storage for space volumes.

Steps

Archive a space

  1. In the left rail, open Spaces.
  2. On the space’s card, click Archive. It is shown for stopped spaces. For a space that is running, open the card’s menu (More actions) and choose Archive space, or click Archive in the toolbar on the space page. Marshal stops a running space first.
  3. Read the confirmation and click Archive.

Restore a space

  1. On the Spaces page, in the group Archived, click View all. Or click Manage archive. You can also go straight to /archive.
  2. Find the space. Each row shows the date it was archived and a countdown such as “3d left”.
  3. Click Restore.
  4. Go back to Spaces and click Start on the restored space, to run it again.

Delete for good

On the Archive page, click Delete on a row and confirm. This removes the space and its workspace. It cannot be undone.

From the CLI

Install and sign in first: Install the CLI.

marshal spaces archive <id>
marshal spaces restore <id>
marshal spaces resume <id> --connect
  • <id> can be the ID, the name, or a unique prefix.
  • archive stops the space first if it is running. It does not ask for confirmation.
  • restore moves the space back to the stopped state and prints a hint to run resume.
  • To fork an archived space, restore it first. marshal spaces fork works on stopped spaces.

What you should see

  • After you archive: the space leaves your active list and shows in the Archived group and on the Archive page.
  • After you restore: a toast “Space restored” with “It’s now in your stopped spaces list.”
  • A row at 0 days left says “Deleting soon”.
  • The first start after a restore downloads the workspace backup, so it takes longer than a usual resume.

Marshal deletes an archived space and its backup after a retention period. The period is 7 days by default, and your admin can change it with the Archived Space Retention (days) setting. The Archive page shows the days left.

Next

Create a space from a manifest: start fresh for the next piece of work.

Approve a blocked domainRead the audit log