GitLab
Migrate from GitLab CE/EE
Preserve branches, issues, merge requests, and CI/CD variables. Includes database sync and runner configuration mapping.
Migration Guides
Move your repositories, CI/CD pipelines, and team workflows to .git with zero downtime. Step-by-step instructions for every platform.
Bitbucket
Migrate from Bitbucket Cloud
Seamlessly transfer repositories, webhooks, and pipeline configurations. Auto-converts bitbucket-pipelines.yml to .gitflow.yml.
GitHub
Migrate from GitHub
Move repos, issues, PRs, and GitHub Actions workflows. Includes secret migration and runner replacement strategy.
Local / CLI
Import Local Repositories
Bulk import bare git repositories using the .git CLI. Preserves git reflog, tags, and annotated commits without history loss.
Enterprise
Enterprise & Self-Hosted Migration
Zero-downtime migration for large orgs. Covers SAML/SCIM sync, audit log export, compliance mapping, and RBAC migration.
CI/CD
Replatform CI/CD Pipelines
Convert Jenkins, CircleCI, and Travis configs to .gitflow. Auto-maps stages, caches, artifacts, and deployment triggers.
GitLab
Step-by-Step: Migrate from GitLab CE/EE
This guide walks you through migrating repositories, CI/CD variables, and team permissions from GitLab to .git. Estimated time: 15 minutes.
💡
Before starting, ensure you have Administrator access to your GitLab instance and the
.git CLI installed: npm i -g @git/cli1. Install & Authenticate
# Authenticate with .git
git auth login
# Select: GitLab CE/EE → OAuth or Token
git auth connect --provider gitlab --token <YOUR_GITLAB_TOKEN>
2. Scan & Validate Repositories
Run a dry-run to analyze repository sizes, branch counts, and CI/CD variable mappings.
git migrate scan --dry-run --group <gitlab-group-path>
# Output: Found 14 repos, 327 branches, 89 CI/CD variables
# 3 warnings detected (see audit.log)
⚠️
GitLab-specific CI/CD rules using
$CI_PIPELINE_SOURCE or $CI_MERGE_REQUEST_IID will be auto-converted to .git native conditionals. Review the generated .gitflow.yml before pushing.3. Execute Migration
- Sync bare repositories and preserve git reflogs
- Map GitLab projects to .git organizations
- Migrate CI/CD variables as encrypted secrets
- Recreate branch protection rules and deployment environments
git migrate execute --group <gitlab-group-path> --parallel 4
# Migrating repo/alpha... ✓
# Migrating repo/beta... ✓
# CI/CD variables synced: 89/89
# Migration complete. Verifying checksums...
4. Post-Migration Verification
Run the verification suite to ensure all commits, tags, and pipeline triggers are intact.
git migrate verify
# ✓ Repository history matches
# ✓ CI/CD triggers functional
# ✓ Permissions mapped correctly
# Ready to cut DNS & decommission GitLab instance
🚀
Pro Tip: Use
git migrate rollback --snapshot <id> if you need to revert within the 7-day grace period. Data remains encrypted and isolated.