> ## Documentation Index
> Fetch the complete documentation index at: https://catalyst.leifiyo.dev/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Import and export

> Move Catalyst servers with manifest-backed zip archives.

Catalyst can export a server to a zip archive and import a compatible archive as a new server.

## Export

Export creates a zip file with a `manifest.json` and the server contents.

Excluded folders include:

* `logs/`
* `backups/`
* `cache/`

<Info>
  Backups are intentionally excluded from exports. Export the backup files separately if you need to preserve historical recovery points.
</Info>

## Import

Import reads a zip archive, validates the manifest, and extracts the server into a new server folder.

Catalyst protects import by checking:

* `manifest.json` exists.
* Entry count is within the configured limit.
* Uncompressed size is within the configured limit.
* Zip entries do not escape the target folder.
* The imported server gets a safe, collision-free folder name.

## When to use each tool

<Columns cols={2}>
  <Card title="Use export" icon="package-open">
    Move a server to another machine, archive a shareable copy, or hand a server to another admin.
  </Card>

  <Card title="Use backups" icon="archive">
    Keep local restore points for the same server over time.
  </Card>
</Columns>

<Warning>
  Stop the server before exporting or importing related data. This avoids partially written world files and plugin data.
</Warning>