Version: current

Cloud backup

It is possible to store your device's backup on MikroTik's Cloud server. The backup service allows you to upload an encrypted backup file, download it and apply the backup file to your device as long as your device is able to reach MikroTik's Cloud server. Below you can find operation details that are relevant to the IP/Cloud's backup service:

1 free backup slot for each device.
Allowed backup size: 15MB.
Sends encrypted packets to cloud2.mikrotik.com using UDP/15252 and TCP/15252 ports.

To create a new backup and upload it to the MikroTik's Cloud server:

[admin@MikroTik] > /system/backup/cloud/upload-file action=create-and-upload password=test123!!!
[admin@MikroTik] > /system/backup/cloud/print 
 0 name="cloud-20180921-162649" size=13.2KiB ros-version="6.44beta9" date=2018-09-21 16:26:49 status="ok" secret-download-key="AbCdEfGhIjKlM1234567890" 

warning

The create-and-upload action command will create a new system's backup file, encrypt the backup file with AES using the provided password and upload it. For the upload action command the password property has no effect since the upload action command uploads only already created system's backup files.

To download the uploaded backup file and save it to the device's memory:

[admin@MikroTik] > /system/backup/cloud/download-file action=download number=0
### OR
[admin@MikroTik] > /system/backup/cloud/download-file action=download secret-download-key=AbCdEfGhIjKlM1234567890

warning

Warning: The secret-download-key is a unique identifier that can be used to download your encrypted backup to your other devices. Since you can download your encrypted backup from any location and any device by using the secret-download-key, you should try to keep this identifier a secret. The downloaded backup is still encrypted using AES; nevertheless, make sure you are using a strong password!

To remove the uploaded backup:

/system/backup/cloud/remove-file number=0

To replace an existing file with a new backup file, use the following command:

/system/backup/cloud/upload-file action=create-and-upload replace=_your_previously_created_backup_file_ password=test123!!!

To upload an existing backup file (created previously):

[admin@MikroTik] > /system/backup/save encryption=aes-sha256 name=old_backup password=test123!!!
[admin@MikroTik] > /system/backup/cloud/upload-file action=upload src-file=old_backup.backup
[admin@MikroTik] > /system/backup/cloud/print 
 0 name="cloud-20180921-164044" size=13.2KiB ros-version="6.44beta9" date=2018-09-21 16:40:44 status="ok" secret-download-key="AbCdEfGhIjKlM1234567890"

warning

Make sure that the backup was encrypted using AES, otherwise, the IP/Cloud will reject the backup upload. Since there is only 1 free backup slot per device, you need to remove the existing backup before uploading a new one.

Properties

Sub-menu: /system/backup/cloud

Below you can find commands and properties that are relevant to the specific command, other properties will not have any effect:

download-file

Property	Description
action (download)	Downloads an uploaded backup file from MikroTik's Cloud server.
number (integer)	Specifies the backup slot on MikroTik's Cloud server. The free backup slot is always going to be in the `0th` slot.
secret-download-key (string)	Unique identifier that can be used to download your uploaded backup file. When downloading the uploaded backup file, you do not have to be using the same device, from which the backup was uploaded. Useful when deploying a backup on a new device.

remove-file

Property	Description
number (integer)	Deletes the backup file in the specified backup slot. The free backup slot is always going to be in the `0th` slot.

upload-file

Property	Description
action (create-and-upload)	Uploads a backup file to MikroTik's Cloud server. `create-and-upload` - creates a new backup file with the specified password and uploads it `upload` - uploads a created system's backup file.
name (string)	Specifies the backup's name that will show up in the uploaded backups list. This is NOT the source backup's name, this name is only used for visual representation.
src-file (file)	Backup's file name to upload that was created using `/system/backup`. This property only has an effect when the action is set to `upload`.
password (string)	Creates, encrypts and uploads a backup file with the specified password. This property only has an effect when the action is set to `create-and-upload`.

Properties​

Properties