Configuration backups

Use configuration backups to save and restore the services configuration of a Beam device. Backup and restore only apply to services created on the device. Backups are stored as .tar.gz files in cloud storage and can optionally include the device's asset file.

Where to find it

To view backups for a specific device:

1. Go to Devices, and select a device.
2. Click on the device.
3. Select Configuration backups.

To view backups across all devices, under one view

1. go to Devices
2. Click All config backups button.

Create a backup

1. Open the device's Configuration backups page
2. Click Backup Now button.
3. The Backup name field is pre-filled with {devicename}-{datetime}. Edit it or keep it as-is.
4. To include the device's asset file, check Backup asset file.
5. Click Create.

Restore a backup

Restore to the current device

Available only from a device-specific Configuration backups page.

1. Open Configuration backups for the device
2. Configuration backups page lists all backups for the device
3. Click on the backup you want to restore
4. Click Restore in the menu.
5. To restore the asset file, check Restore asset file (only applies if the backup includes one).
6. Click Restore to confirm.

Restore to a different device

1. Open Configuration backups page
2. Click on the backup row you want to restore
3. Click Restore to devices....
4. To restore the asset file, check Restore asset file.
5. Select one or more target devices.
6. Click Restore.

MK.IO restores the backup to all selected devices simultaneously. If only some devices fail, the successful restores are still applied and an error is shown for the failed ones.

Rename a backup

1. On a backup row, click
2. Click Rename backup.
3. Enter a new Backup Name.
4. Click Save.

Download a backup

1. On a backup row, click
2. Click Download backup.
3. The .tar.gz file downloads to your local machine. You can re-upload downloaded backups to the same or a different project.

Upload a backup

1. Go to device's Configuration backups page
2. Click Upload button.
3. In the Upload backup file drawer, drag and drop or select a .tar.gz backup file previously downloaded from MK.IO.
4. Click Upload.

MK.IO verifies the file's signature, customer ID, and metadata before accepting it. Once uploaded, the backup appears in the list and can be restored like any other.

Delete a backup

1. On a backup row, click
2. Click Delete backup.
3. Click Delete to confirm.