---
title: "tractorbeam export"
description: "Export the Workspace."
sidebar:
  label: "export"
  order: 17
---

Export the Workspace to its own storage and print the export's ID once it succeeds. Pass `--output` to download its archive too.

```sh
tractorbeam export [flags]
```

| Flag | Description |
| --- | --- |
| `--output <string>` | Also download the export's archive to this file. |
| `--config <string>` | The Project's `tractorbeam.config.ts`. Defaults to the one in the current directory or its nearest ancestor. |
| `--workspace <string>` | Workspace identifier or resource name. Environment variable: `TRACTORBEAM_WORKSPACE`. |
| `--origin <string>` | The Tractorbeam origin to call instead of the default, such as a proxy's. Environment variable: `TRACTORBEAM_ORIGIN`. |
| `--token <string>` | Access token. Defaults to the saved interactive session. Environment variable: `TRACTORBEAM_TOKEN`. |

Examples:

```sh
# Export the Workspace
tractorbeam export

# Export it and download the archive
tractorbeam export --output workspace.tar.zst
```
