# backup: List, create, or restore backups

Source: https://zotonic.com/docs/3006/backup-list-create-or-restore-backups

URI: https://zotonic.com/id/3006

Language: en

List, create, or restore backups.

Syntax
------

```text
bin/zotonic backup <site_name> list|start|restore|download [backup_name]
```

Requirements and effects
------------------------

Requires a running site with mod\_backup. Listing is read-only; the other operations change backup or site data.

`list` lists backups; `start` requests a backup. `restore <backup_name>` asks you to type the site name and choose whether to restore configuration and security files; database and files are the default. **`download` downloads and restores the newest backup**, requires the backup environment, and asks for confirmation. Restore makes the destination unavailable. Check completion and restored content afterwards; some failure paths print an error without a failing exit status.

Example
-------

```sh
bin/zotonic backup garden list
```

Run commands from the Zotonic workspace root. Replace `garden` with your site name where applicable.

License: 

Attribution: 

Related resources: https://zotonic.com/api/agent/related/3006?language=en


## API access

- [API help](<https://zotonic.com/api-help>)
- [OpenAPI specification](<https://zotonic.com/openapi.json>)
- [This resource as JSON](<https://zotonic.com/api/agent/resource/3006?language=en>)
