GitHub to GitLab Migration Guide

A practical guide for engineers in the middle of a migration.

GitLab 18.x

Move from GitHub to GitLab.

This guide gets you to the import button with everything you'll need: prerequisites, the methods that actually work, what migrates, and what you'll have to rebuild.

Start your import on GitLab Read the guide

4 steps GitLab 18.4+ GitHub.com & Enterprise

Start here

Recommended · Step-by-step

Migration Guide

End-to-end import flow: prerequisites, the three methods, monitoring an import, user contribution mapping, and the cutover checklist.

Covers: prerequisites · methods · user mapping · cutover · what migrates

Open guide →

Conversion · Workflows

Actions to CI/CD

Translate GitHub Actions workflows to .gitlab-ci.yml with concept and syntax mappings, plus working examples.

Open conversion →

Tooling · AI assist

AI-Assisted Migration

Use GitLab Duo and frontier models for planning, workflow conversion, validation, and post-import cleanup.

Open tooling →
For
Engineers running the migration. Assumes Maintainer or Owner on the destination GitLab group, command-line access, and familiarity with GitHub Actions.
Covers
GitLab 18.x · GitHub.com and GitHub Enterprise Server · one repo at a time or batched via the REST API.
Not
Whether to migrate · enterprise rollouts · licence and pricing trade-offs.