Skip to main content

Backups

Overview​

The Profile Backup feature enables you to generate, download, and manage comprehensive backups of your profile data stored in TagoIO. This ensures you never lose critical configuration data and always have access to a complete snapshot of your IoT infrastructure.

Backups are retained for 12 months and focus on data preservation and export. Resources are saved as structured JSON files and can be used to recreate your environment. Restoration options include:

:::info Availability Backups are available for paid plans: Starter and Scale. :::

Accessing Backups​

Go to your profile name in the bottom-left corner of the screen and select Backups. You will be taken to the Manage Backups page.

<img src="/img/my-account/backups/manage-backups.png" alt="Manage Backups page" style={{border: '1px solid #d1d5db', borderRadius: '8px'}} />

Creating a Backup​

On the Manage Backups page, click Create Backup. A modal will list all resources included and excluded before you confirm.

Resources Included​

ResourceAll uploaded files and documentsDashboard layouts and versionsAnalysis scripts and versionsDevice configurationsActions, networks, connectorsAccess management policiesNetwork configurationsConnector configurationsProfile secretsDictionary configurationsTagoRUN usersTagoRUN configurationService authorization tokensProfile settings and allocationsTeam members

Resources Not Included​

ResourceDevices dataEntities data

Downloading a Backup​

Find the backup in the list and click the download icon (⬇️) in the Actions column. You will be asked to verify your account password. The backup is downloaded as a ZIP file with the following structure:

backup-<profile-id>/
├── files/
│   ├── <uploaded files and documents>
│   └── devices/
│       └── <device-id>/
│           └── <device files>
├── resources/
│   ├── access_management.json
│   ├── actions.json
│   ├── analysis.json
│   ├── connectors.json
│   ├── dashboards.json
│   ├── devices.json
│   ├── dictionaries.json
│   ├── networks.json
│   ├── profile.json
│   ├── run_users.json
│   ├── run.json
│   ├── secrets.json
│   └── service_authorization.json
└── versioning/
    └── dashboard/
        └── <version files in JSON>

Restoring a Backup​

Backups are designed for data preservation, not automatic one-click restore. There is no restore option in the UI. To restore resources from a backup, choose one of the options below.

Option 1: Manual Script-Based Restoration​

  1. Download and extract the backup ZIP file.
  2. Read the JSON files for the resources you need to restore.
  3. Use the TagoIO API to recreate resources programmatically.

Option 2: TagoIO CLI​

Make sure you have the TagoIO CLI installed and authenticated, then run:

tagoio backup restore

The CLI fetches all available backups and displays them as a selectable list, each entry shows the creation date, file size, and backup ID. Use the arrow keys to pick the one you want to restore.

<img src="/img/my-account/backups/cli-restore-selection.png" alt="CLI backup restore selection" style={{border: '1px solid #d1d5db', borderRadius: '8px'}} />

After selecting a backup, you will be prompted to confirm and authenticate with your resources password, 2FA method, and OTP code. Once authenticated, the CLI downloads and extracts the backup, shows a summary table of all resources and their counts, and asks for a final confirmation before starting the restoration.

warning

IDs are NOT restored. New IDs will be generated for all resources. Any external references to resource IDs will need to be updated.

Option 3: Contact TagoIO Support​

For large-scale restoration or complex recovery scenarios, contact TagoIO support. Our team can assist with full profile restoration, selective resource recovery, and migration between profiles or accounts.

important

Support-assisted restoration may involve an additional cost.

What Cannot Be Automatically Restored​

Automated Backups via Actions​

You can schedule automatic backups using TagoIO Actions with the profile_backup action type.

Supported Triggers​

TriggerDescriptionResourceFires when a specific resource event occursConditionFires based on data conditionsScheduleFires at a specific time (e.g., daily at 2 AM)IntervalFires at regular intervals

Setting Up​

Navigate to Actions in your TagoIO Admin, create a new action, and select Profile Backup as the action type. Configure your desired trigger and activate the action.

tip

Schedule backups during low-activity periods and use daily or weekly schedules for production environments. Keep an eye on your daily backup limit to ensure scheduled backups don't get blocked.

Limits & Considerations​

General​

For the daily backup creation limit per plan, see Resource Limits.

For the API rate limits (RPM) that apply to backup operations, see Rate Limits (Hard Limits).