Repositories

Repositories in Forkline link your git repositories to runners, storing configuration, secrets, and automation settings.

Overview

A Forkline repository represents a connection between:

  • Your git repository (GitHub, GitLab, Forgejo)
  • Runner configuration (size, model, setup scripts)
  • Secrets (API keys, credentials)
  • Automation settings (webhooks, auto-fix)

Info: Repositories sync automatically from your git connectors. Activate them to start runners.

How Repositories Work

Automatic Sync

When you connect a git provider, Forkline automatically discovers your repositories:

  1. Connect a git provider on the Git Providers page
  2. Forkline syncs accessible repositories
  3. Repositories appear on the Repositories page as “Available”

Repository States

StateDescriptionActions Available
AvailableSynced but not activatedActivate to enable runners
ActiveReady for runnersStart runners, configure settings
DeactivatedDisabled, pending deletionReactivate or delete permanently

Repositories page - available repository

Activating a Repository

  1. Navigate to Repositories
  2. Find the repository in the list
  3. Click the Activate button

Repository activation button

Once activated, you can:

  • Start runners
  • Configure settings
  • Add secrets
  • Enable automation

Note: Only activated repositories can run tasks. Available repositories are synced but not configured.

Repository Settings

Access settings for an active repository:

  1. Click Settings on the repository card
  2. Configure:
    • Default runner size
    • Default model
    • Automation options

Repository settings modal - General tab

The settings modal has three tabs:

  • General: Configure default runner size and model
  • Automation: Enable auto-fix features and set trigger policies
  • Secrets: Store sensitive credentials
SettingDescriptionDefault
Default Runner SizeSize for new runnersAccount default
Default ModelAI model for runnersAccount default

Deactivating a Repository

When you deactivate a repository:

  1. Click the repository status button to deactivate it
  2. Confirm the deactivation

Effects:

  • All active runners are stopped
  • Configuration is retained for 7 days
  • After 7 days, configuration is permanently deleted

Tip: Deactivated repositories show as “Available” and can be reactivated within 7 days.

Permanently Deleting

To permanently remove a repository’s configuration:

  1. Find a deactivated repository
  2. Click Delete config
  3. Confirm the action

Warning: This permanently removes the repository configuration, secrets, and any remaining runners. Your git repository is NOT affected.

Next Steps