AIOZ Backups

Off-site file backups of your deployment data to AIOZ decentralized storage.

Overview

While volume snapshots keep copies on the provider node, AIOZ backups store your data off-site on a decentralized storage network. This protects against provider-level failures -- if a provider goes offline, your data is still recoverable from AIOZ.

Backups capture the contents of your deployment's volumes and store them as encrypted archives on the AIOZ network.

Enabling Backups

Open deployment settings

Navigate to your deployment's detail page and click the Settings tab.

Enable backups

Find the AIOZ Backups section and toggle it on.

Configure schedule

Set your preferred backup frequency and retention policy, then click Save.

Backups begin on the next scheduled interval after being enabled.

Backup Schedule and Retention

Setting	Default	Description
Frequency	Every 24 hours	How often backups run
Retention	7 backups	Number of backups to keep before pruning oldest
Max size	50 GB	Maximum volume size eligible for backup

You can adjust the frequency from hourly to weekly depending on how often your data changes. The retention count applies to completed backups only -- in-progress or failed backups don't count against it.

Restoring from Backup

Open the Backups tab

Navigate to your deployment and click the Backups tab to see all available backups.

Select a backup

Find the backup you want to restore by date and click Restore.

Confirm the restore

Confirm the operation. The backup is downloaded from AIOZ and written to your deployment's volume. The container restarts once the restore is complete.

Restore Replaces Data

Restoring from a backup replaces the current volume contents. Take a snapshot before restoring if you want to preserve the current state.

Failed Backup Retries

If a backup fails (network timeout, provider issue, AIOZ unavailability), Kova retries automatically every 5 minutes for up to 1 hour. You can see retry status on the Backups tab:

Status	Description
Completed	Backup successfully stored on AIOZ
In Progress	Backup currently uploading
Retrying	Previous attempt failed, retrying automatically
Failed	All retry attempts exhausted

Failed backups don't count against your retention limit. The next scheduled backup runs regardless of whether the previous one succeeded.

Backups vs Snapshots

Backups and volume snapshots are independent systems. Snapshots are fast, local copies on the provider node -- great for quick rollbacks. Backups are off-site copies on AIOZ -- meant for disaster recovery. Use both for comprehensive data protection.

API Reference

List Backups

curl -H "Authorization: Bearer $TOKEN" \
  https://app.kovanetwork.com/api/v1/deployments/:id/backups

Response:

{
  "success": true,
  "backups": [
    {
      "id": "bk-x9y8z7",
      "status": "completed",
      "size": "1.8 GB",
      "createdAt": "2026-02-10T03:00:00Z"
    }
  ]
}

Trigger Manual Backup

curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  https://app.kovanetwork.com/api/v1/deployments/:id/backups

Restore from Backup

curl -X POST \
  -H "Authorization: Bearer $TOKEN" \
  https://app.kovanetwork.com/api/v1/deployments/:id/backups/:backupId/restore