Migrate from GitHub

Drok provides a one-command migration path from GitHub. The import process preserves the complete repository history — every commit, every branch, every tag — and optionally migrates issues, pull requests (converted to merge requests), labels, milestones, and wiki content.

Quick Migration

Import a single repository:

drok import github your-org/your-repo

This clones the repository with full history and pushes it to your Drok account at drok.us/your-username/your-repo.

Organization Migration

Import an entire GitHub organization:

drok import github --org your-org --all

This imports every repository in the organization, preserving the org structure. Requires a GitHub personal access token with repo and read:org scopes.

What Gets Migrated

Component	Migrated	Notes
Git history	Yes	Complete — every commit, branch, tag
Issues	Yes	With comments, labels, assignees, milestones
Pull requests	Yes	Converted to merge requests with review comments
Labels	Yes	Colors and descriptions preserved
Milestones	Yes	With due dates and descriptions
Wiki	Yes	Converted to repository wiki
Releases	Yes	With assets and release notes
Branch protection	Yes	Converted to Drok branch protection rules
CODEOWNERS	Yes	Syntax is identical
Actions workflows	Partial	Converted to `.lehub/pipeline.yml` where possible

Authentication for Import

The import tool requires a GitHub personal access token:

drok import github your-org/your-repo --github-token ghp_xxxxxxxxxxxx

Or set it as an environment variable:

export GITHUB_TOKEN=ghp_xxxxxxxxxxxx
drok import github your-org/your-repo

The token is used only for the import operation and is not stored.

Post-Migration

After importing:

Update your remotes — Switch local clones to point to Drok:

git remote set-url origin https://drok.us/your-username/your-repo.git

Configure Pipelines — Convert GitHub Actions workflows to Drok Pipelines. See Pipelines.
Update CI/CD badges — Replace GitHub status badges with Drok pipeline badges.
Invite collaborators — Set up your organization and team structure. See Teams.

Parallel Operation

You do not need to migrate all at once. Drok and GitHub can operate in parallel during your transition. Push to both remotes, run CI on both platforms, and migrate teams incrementally as confidence builds.

git remote add drok https://drok.us/your-username/your-repo.git
git push drok main
git push origin main