User Guide: Database Backups - EyevinnOSC/community GitHub Wiki

Database Backups

The Databases tab in My Apps lets you manage automatic and on-demand backups for database instances you run on OSC. Supported databases include PostgreSQL, MariaDB, Valkey, ClickHouse, and CouchDB.

Backups are stored in OSC-managed object storage (MinIO). Automatic backups run on a schedule; you can also trigger a backup immediately at any time.

Prerequisites

  • An Eyevinn Open Source Cloud account on a paid plan. Automatic and on-demand backups are not available on the Free plan.
  • At least one database service instance running in your OSC account (PostgreSQL, MariaDB, Valkey, ClickHouse, or CouchDB).

Using the Databases Tab

View your databases

  1. Go to My Apps
  2. Click the Databases tab
  3. All your database instances are listed with their type and creation date

Enable automatic backups

  1. Find the database instance you want to back up
  2. Toggle the Auto Backup switch to on
  3. OSC schedules periodic backups for that instance (approximately every 15 minutes when a backup is due based on policy)

To disable automatic backups, toggle the switch back to off.

Note: The Auto Backup toggle is disabled on the Free plan. The text "Paid plan required" appears next to the toggle. Upgrade your plan to enable it.

Last Backup Time

The Databases tab shows a Last Backup column with the relative time of the most recent backup for each instance (e.g., "2 hours ago"). If no backup has been taken yet, the column shows "—". This helps you quickly verify that automatic backups are running as expected.

Trigger a manual backup

  1. Find the database instance in the Databases tab
  2. Click Backup Now
  3. A confirmation message appears briefly once the backup is triggered

The backup runs asynchronously. The "Backup Now" button shows a loading state while the request is in progress.

Using MCP (AI Agent)

If you have OSC connected to an AI agent, you can manage database backups through natural language.

Trigger a backup

Back up my PostgreSQL database called mydb

The agent uses the create-backup tool and will confirm the backup name and status once triggered.

List existing backups

List backups for my CouchDB instance called nosql

The agent uses the list-backups tool and returns a table of backup records with name, status, and creation date.

Restore from a backup

Restore my database called mydb from the most recent backup

The agent uses the restore-backup tool. It will identify the correct backup record and trigger a restore job.

Warning: Restoring a database overwrites current data with the backup snapshot. Always verify you are restoring the right backup before confirming with the agent.

Related Resources