Skip to main content

Creating Backups

You can create backups on demand or automate them with schedulers.

On-Demand Backups​

To manually trigger a backup:

  1. Navigate to Repositories > GitHub or Repositories > Bitbucket in the sidebar.
  2. Click on the repository you want to back up.
  3. On the repository detail page, click the Backup button.
  4. The backup job will start immediately. Track progress in the Activity tab.

Scheduled Backups​

Automate backups by creating a scheduler:

  1. Open the repository detail page.
  2. Go to the Scheduler tab.
  3. Fill in the scheduler form: name, type (Minutely/Hourly/Daily/Weekly/Monthly/Custom CRON), time, timezone, and included items.
  4. Save the scheduler.

The backup will run automatically at the configured time. See Creating a Scheduler for step-by-step instructions.

Push Event Backups​

Trigger a backup every time code is pushed:

  1. Open the repository detail page.
  2. Go to the Push Event tab.
  3. Enable the push event toggle.
  4. Select which scopes to include.

See Push Event Backups for full details.

Backup Status​

Each backup execution reports one of seven statuses: Pending, In Progress, Completed, Partially Completed, Failed, Cancelled, or Paused. The two most common outcomes are:

  • Completed: All selected scopes were backed up without errors.
  • Failed: The backup encountered an error. Check the Activity or Audit Logs page for details.

See Viewing Backups for what each status means and how to filter the backup list by status.

What Happens During a Backup?​

  1. GitSec authenticates with your Git provider using the installed app.
  2. The selected data scopes are downloaded via the provider's API.
  3. The data is encrypted and stored in your configured storage location.
  4. A backup snapshot record is created with metadata (timestamp, size, scopes, status).