Skip to main content
Coming Soon — Closed AlphaGitHub Integration is currently in closed alpha testing. Want early access? Join our Discord and let us know!
GitHub Integration

​
Overview

Connect your GitHub account to keep full ownership of your code. When Cerebrum builds services for you, the code lives in your repositories — you control it, you own it.
New to GitHub? It’s a cloud platform for storing and versioning code. When you link a service to GitHub, the repo becomes the source of truth for that service’s code.

​
Why Connect GitHub

Own your code

All code Cerebrum creates goes to your GitHub. No lock-in, full ownership.

Work your way

Clone repos, use your favorite IDE, collaborate with your team via PRs.

Import existing projects

Already have code on GitHub? Create Ardor services directly from your repos.

Auto-deploy on push

Push to a branch, Ardor deploys automatically. Standard Git workflow.
Recommended: Connect GitHub early. It’s easier to start with GitHub integration than to export later.

​
Before You Connect

You need a GitHub account or organization where Ardor can access repositories.
Each service can have its own GitHub repo. A solution may contain multiple services with different repos.
A service points to a single Git repository. You can’t attach multiple repos to one service.
If you rename, delete, or transfer the GitHub repo outside Ardor, syncing and deployments will break.
When exporting from Ardor to GitHub, a new repository is always created to avoid overwriting existing code.

​
Setup Process

1

Connect GitHub Account

Link your GitHub identity via OAuth
2

Install Ardor GitHub App

Grant Ardor permission to read/create repos
3

Create or Export Services

Import from GitHub or export existing Ardor services
Only workspace admins can manage GitHub integration.

​
Setup

​
Step 1: Connect Your GitHub Account

  1. Go to Workspace Settings → General → Integrations → GitHub
  2. Click Connect GitHub
  3. Authorize Ardor to access your GitHub account
Nothing syncs yet — this step just verifies your GitHub identity.

​
Step 2: Install the Ardor GitHub App

After connecting your account, install the GitHub App to grant Ardor repo access:
  1. Choose where to install — personal account or organization
  2. Select All repositories or specific ones
  3. Click Authorize Ardor
After installation, Ardor can create repos, read code, and listen to commits for deployments.

​
Using GitHub with Ardor

Once setup is complete, you have two ways to use GitHub with your services:

​
Scenario A: Import from GitHub

Use this when: You already have code on GitHub and want to deploy it through Ardor.
Step 1Click Add Service → From GitHub Repo
Ardor clones the repo, creates the service, and sets up deployment triggers.
This flow is for importing existing GitHub repos. If you already have a service in Ardor’s internal Git, use Export to GitHub instead (see below).

​
Scenario B: Export to GitHub

Use this when: Cerebrum built a service for you in Ardor, and you want to move the code to your own GitHub account. Export to GitHub
  1. Open the service
  2. Go to Settings → General
  3. Click Convert to GitHub
  4. Confirm the transfer
Ardor creates a new GitHub repo, pushes your full commit history, and links the service to that repo going forward.
Export always creates a new repository — you can’t select an existing one.

​
Managing GitHub-Linked Services

Services linked to GitHub:
  • Show repository details in the service settings
  • Sync commits automatically
  • Deploy based on your configured branch triggers
These services can’t be “unlinked” — GitHub is their source of truth.

​
Disconnect GitHub

To revoke Ardor’s access:
  1. Go to GitHub → Settings → Applications → Installed GitHub Apps
  2. Find Ardor and click Revoke Access
After revoking, Ardor can’t read or create repos. Git-backed services stop syncing until you reconnect.