Backups¶

BinDist provides automated and manual backup capabilities to protect your data.

Backup Types¶

Type	Description	Frequency
`AUTOMATIC`	System-generated backups	Daily
`MANUAL`	User-triggered backups	On-demand

What's Included in Backups¶

Backups include:

Metadata - Application definitions, versions, customers
Binary files - All uploaded application files
Configuration - Account settings and permissions

Listing Backups¶

View available backups:

curl -H "Authorization: Bearer YOUR_ADMIN_API_KEY" \
  https://api.bindist.eu/v1/control/tenants/YOUR_TENANT_ID/backups

Response:

{
  "success": true,
  "data": {
    "backups": [
      {
        "backupId": "bak_20250115_auto",
        "backupType": "AUTOMATIC",
        "status": "COMPLETED",
        "sizeBytes": 1073741824,
        "createdAt": "2025-01-15T03:00:00Z",
        "expiresAt": "2025-04-15T03:00:00Z"
      },
      {
        "backupId": "bak_20250114_manual",
        "backupType": "MANUAL",
        "status": "COMPLETED",
        "sizeBytes": 1073741824,
        "createdAt": "2025-01-14T10:30:00Z",
        "expiresAt": "2025-04-14T10:30:00Z"
      }
    ]
  }
}

Starting a Manual Backup¶

Trigger a backup immediately:

curlJavaScript

curl -X POST \
  -H "Authorization: Bearer YOUR_ADMIN_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"backupType": "MANUAL"}' \
  https://api.bindist.eu/v1/control/tenants/YOUR_TENANT_ID/backups

const result = await client.startBackup('MANUAL');
if (result.success) {
  console.log('Backup started:', result.data.backupId);
}

Response:

{
  "success": true,
  "data": {
    "backupId": "bak_20250115_manual",
    "status": "IN_PROGRESS",
    "createdAt": "2025-01-15T10:30:00Z"
  }
}

Backup Duration

Backup time depends on the amount of data. Large accounts may take several minutes.

Getting Backup Contents¶

View the contents of a backup with download URLs:

curl -H "Authorization: Bearer YOUR_ADMIN_API_KEY" \
  "https://api.bindist.eu/v1/control/tenants/YOUR_TENANT_ID/backups/bak_20250115_auto?generateUrls=true"

Response:

{
  "success": true,
  "data": {
    "backupId": "bak_20250115_auto",
    "status": "COMPLETED",
    "contents": {
      "metadata": {
        "downloadUrl": "https://s3.amazonaws.com/...",
        "sizeBytes": 1048576
      },
      "files": [
        {
          "applicationId": "my-app",
          "version": "2.1.0",
          "fileName": "my-app-2.1.0.exe",
          "downloadUrl": "https://s3.amazonaws.com/...",
          "sizeBytes": 15728640
        }
      ]
    }
  }
}

Downloading Backup Files¶

Use the pre-signed URLs to download backup files:

# Download metadata
curl -o metadata.json "METADATA_DOWNLOAD_URL"

# Download application file
curl -o my-app-2.1.0.exe "FILE_DOWNLOAD_URL"

URL Expiration

Download URLs expire after 1 hour. Request new URLs if needed.

Backup Lifecycle¶

Retention¶

Standard tier: 30-day retention
Premium tier: 90-day retention
Enterprise tier: 365-day retention

Glacier Transition¶

Older backups are automatically moved to S3 Glacier for cost optimization:

Age	Storage Class
0-30 days	S3 Standard
30-90 days	S3 Glacier Instant Retrieval
90+ days	S3 Glacier Deep Archive

Retrieval Time

Glacier Deep Archive restores may take 12-48 hours.

Restore Process¶

To restore from a backup, contact support with:

Your tenant ID
The backup ID to restore from
Whether you want a full restore or specific items

Self-Service Restore

Self-service restore is coming soon. For now, contact support@bindist.eu.

Best Practices¶

Schedule manual backups before major changes
Verify backup contents periodically
Download critical backups to local storage
Test restore procedures in a staging environment
Monitor backup status for any failures

Backup Notifications¶

Set up notifications for backup events:

Go to Account Settings
Enable "Backup Notifications"
Configure email recipients

You'll receive notifications for:

Backup completion
Backup failures
Low storage warnings