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 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 results in one of two statuses:

• Success — All selected scopes were backed up without errors.
• Failed — The backup encountered an error. Check the Activity page for details.

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).