Service backups

Learn how Aiven backs up your services automatically, where backups are stored, and how to change your backup schedule.

All Aiven services, except for Aiven for Apache Kafka®, have automatic encrypted backups.

Backups are stored in the object storage of the cloud region where the service is created, for example, S3 for AWS or Google Cloud Storage for Google Cloud.

note

If you change a service's cloud provider or an availability zone, its backups are not migrated from their original location.

Whenever a service is powered on from a powered-off state, the latest available backup is automatically restored.

Backups are automatically deleted 30 days after the service's deletion date.

Access to backups

Backups are encrypted and not available for download, but you can create your own backups with the appropriate tooling:

• PostgreSQL®: pgdump
• MySQL®: mysqldump
• OpenSearch®: elasticdump
• Valkey™: valkey-cli

Edit the backup schedule

To edit the backup schedule for your service:

Console

1. In your service, Backups.
2. Click Actions > Configure backup settings.
3. Click Add configuration options.
4. Add backup_hour and backup_minute, and set their values.
5. Click Save configuration.

Aiven API

Call the ServiceUpdate endpoint, and add the following properties to the user_config object:

curl --request PUT                                                        \
  --url https://api.aiven.io/v1/project/PROJECT_NAME/service/SERVICE_NAME \
  --header 'Authorization: Bearer YOUR_BEARER_TOKEN'                      \
  --header 'content-type: application/json'                               \
  --data '{
      "user_config": {
          "backup_hour": BACKUP_HOUR,
          "backup_minute": BACKUP_MINUTE
      }
  }'

Replace the following:

• SERVICE_NAME: the name of your service.
• PROJECT_NAME: the name of your project.
• BACKUP_HOUR: the hour when the service backup starts. Accepted values are integers between 0 and 23.
• BACKUP_MINUTE: the minute when the service backup starts. Accepted values are integers between 0 and 59.

Aiven CLI

Run the avn service update command, and add the following properties to the user_config object:

avn service update SERVICE_NAME \
  --project PROJECT_NAME        \
  --user-config '{
      "backup_hour": BACKUP_HOUR,
      "backup_minute": BACKUP_MINUTE
  }'

Replace the following:

• SERVICE_NAME: the name of your service.
• PROJECT_NAME: the name of your project.
• BACKUP_HOUR: the hour when the service backup starts. Accepted values are integers between 0 and 23.
• BACKUP_MINUTE: the minute when the service backup starts. Accepted values are integers between 0 and 59.

Terraform

Use the backup_hour and backup_minute attributes in your service resource to set the start time for backups.

If a backup was recently made, it can take another backup cycle before the new backup time takes effect.

Related pages

• Track service restore progress using the API
• Backup to another region