Self-host GitLab-CE
v19.5.1DevOps platform for Git hosting, CI/CD, and code review
- Stars
- 24 565
- CPU
- 8 vCPU (single-node baseline)
- RAM
- 16 GB (single-node baseline; can run with at least 8 GB in memory-constrained environments)
- Ports
- 80 (HTTP web UI and Git over HTTP (published 80:80)), 443 (HTTPS web UI and Git over HTTPS), 22 (Git over SSH)
- Requires
- Mail transport agent (MTA), Redis or Valkey
gitlab/gitlab-eeWhat is GitLab-CE?
GitLab is one application that covers the software delivery lifecycle: Git repositories with fine-grained access controls, merge-request review, CI and CD pipelines, and per-project issue trackers, boards and wikis. An instance can additionally run a container registry, serve static sites through GitLab Pages, ship Prometheus monitoring by default, offer exact code search and Elasticsearch-backed advanced search, and replicate across regions with GitLab Geo. This GitHub repository mirrors Community Edition; development happens in the canonical project on GitLab.com, and a read-only mirror exists for cloning without the proprietary tree. Licensing is open-core: CE is MIT, while /ee code is proprietary yet source available and only functional with a Premium or Ultimate subscription. To self-host, pick Omnibus deb/rpm packages (Ubuntu, Debian, AlmaLinux, Oracle Linux, RHEL, Amazon Linux, SUSE in amd64 and arm64), the official Docker images driven by GITLAB_OMNIBUS_CONFIG, a Kubernetes Helm chart or GitLab Operator, or a from-source build; containers also need their own mail transport agent. Plan for a heavy stack: a single node starts at 8 vCPU and 16 GB RAM, PostgreSQL is the only database GitLab supports, and Redis or Valkey holds sessions and background jobs. Microsoft Windows is not supported, and FreeBSD, Arch, Gentoo or macOS builds are possible without any vendor support.
GitLab-CE alternatives
GitnessAn open-source, self-hosted DevOps platform combining Git code hosting, CI/CD pipelines, Gitspaces dev environments and artifact registries in one Docker container.CompareGitness with GitLab-CE
gitbucketA self-hosted, open-source Git platform in Scala: run one war file on Java 17 for repos, issues, pull requests, wiki, LDAP/OIDC logins and GitHub-compatible APIs.Comparegitbucket with GitLab-CE
docmostSelf-hosted, open-source collaborative wiki with real-time editing, diagrams, AI features, and enterprise SSO as a Confluence/Notion alternative.Comparedocmost with GitLab-CE
GerritOpen-source, self-hosted code review and Git repository management server: patchset reviews, fine-grained permissions, plugins, REST API and webhooks.CompareGerrit with GitLab-CE
rgitSelf-hosted, open-source Git web interface in Rust using RocksDB caching and gitoxide for fast browsing with dark mode.Comparergit with GitLab-CE
MirrorProxyMirrorProxy is a self-hosted, open-source mirror acceleration gateway for GitHub, Docker/OCI, language packages, and Linux/BSD repos with access control and quotas.CompareMirrorProxy with GitLab-CE
github-release-monitorA self-hosted tool for monitoring GitHub, GitLab, Codeberg, and Forgejo releases with instant email or Apprise notifications supporting 70+ services.Comparegithub-release-monitor with GitLab-CE
ToolJetSelf-hosted, open-source low-code platform for internal tools and dashboards: visual builder, 90+ data sources, built-in database, AI app generation and MCP agent access.CompareToolJet with GitLab-CE
Should you self-host GitLab-CE?
GitLab-CE scores 78/100 on selfhost.directory (how scoring works) and ranks #4 of 15 in Code Hosting. It has 24 565 GitHub stars, +14 in the last 30 days.
There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.
Setup is advanced: plan for several services and some ongoing maintenance. An official Docker image is available. It is MIT-licensed and written mostly in Ruby.
Its closest alternative on selfhost.directory is Gitea (89/100, 59 114 stars). It scores higher overall, so compare the two before you pick. See GitLab-CE vs Gitea side by side.
Features
- Advanced searchNeeds a separate Elasticsearch or OpenSearch cluster.
- Built-in Prometheus monitoring
- CI/CD Pipelines
- Container Registry
- Exact code searchSeparate service, not part of the core install.
- Git repository hosting
- Issue Tracking
- Merge requests / code review
- Multi-region replication
- Project import from other providers
- Project wikis
- Secrets ManagementPricing page lists it as GitLab.com only, with Self-Managed and Dedicated coming soon.
- Static site hostingRequires a wildcard DNS record; custom domains need a secondary IP and TLS certificates.
- Two-factor authentication enforcement
GitLab-CE README
The canonical source of GitLab where all development takes place is hosted on GitLab.com.
If you wish to clone a copy of GitLab without proprietary code, you can use the read-only mirror of GitLab located at https://gitlab.com/gitlab-org/gitlab-foss/. However, please do not submit any issues and/or merge requests to that project.
You can request a free trial of GitLab Ultimate on our website.
FAQ
What is the 5-user limit on the GitLab.com Free tier?
It only applies to private top-level groups on the GitLab.com Free tier; self-managed Free users and public groups are unaffected.
Do you have special pricing for open source projects, educational institutions, or startups?
Qualifying open source projects, educational institutions and startups can get free Ultimate licenses plus 50K compute minutes per month.
Can I import my projects from another provider?
Yes, projects can be imported from most existing providers, including GitHub and Bitbucket.
Can I acquire a mix of licenses?
No, every user on the instance or GitLab.com group must be on the same plan.
What happens if I decide not to renew my subscription?
The license stops working and Enterprise Edition features become unavailable, but you can keep running the free Community Edition.
Is there a minimum supported version to use specific capabilities?
Yes: GitLab Duo Agent Platform needs at least 18.8 on self-managed, and trialling Ultimate with GitLab Credits needs at least 18.9.
How do I install GitLab Self-Managed?
All supported installation methods are listed in the GitLab install documentation.
What is GitLab Self-Managed?
It is the version of GitLab you install, configure and maintain on your own infrastructure, on-premises or in a cloud you control.
More in Code Hosting
GitnessAn open-source, self-hosted DevOps platform combining Git code hosting, CI/CD pipelines, Gitspaces dev environments and artifact registries in one Docker container.
GitusGitus is a self-hosted, open-source Git forge in Go with no JavaScript, featuring a web installer, SSH access, issues, pull requests, and experimental webhooks.
GogsA lightweight, open-source, self-hosted Git service written in Go: repos, issues, pull requests, wikis and LDAP login, run from one binary or a Docker image.
harnessSelf-hosted, open-source DevOps platform: Git hosting with pull requests, CI/CD pipelines, Gitspaces dev environments, and Docker and Helm artifact registries.
legitOpen-source, self-hosted browsing UI for Git repos, built in Go: serves bare repositories from a folder with custom templates, README rendering and HTTP cloning.
OneDevOneDev is a powerful and simple DevOps platform that integrates Git server, Kanban, CI/CD, and package registries into a seamless experience.- PagurePagure is a lightweight, git-centered forge for hosting projects with documentation, ticketing, and pull-request mechanisms.
rgitSelf-hosted, open-source Git web interface in Rust using RocksDB caching and gitoxide for fast browsing with dark mode.- RhodeCodeRhodeCode is an open-source, self-hosted platform for unified repository management, supporting Git, Mercurial, and Subversion. It provides enterprise-grade security, code review, workflow automation, and permission management for teams.
Roundup Issue TrackerRoundup is a highly customizable issue-tracking system with command-line, web, REST, XML-RPC, and e-mail interfaces. It is designed to be easy to install and use, and can be adapted to various use cases.
scm-managerSelf-hosted open-source repository manager for Git, Mercurial and Subversion with web UI, REST API, and plugin system.
self-forgeself-forge mirrors public GitHub repos and serves them via a minimal, server-rendered web UI with no JavaScript or CSS.
0 comments