selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitLab-CE logo

Self-host GitLab-CE

v19.5.1

DevOps platform for Git hosting, CI/CD, and code review

ReleaseOpen CoreMIT
Updated3 weeks ago
LanguageRuby
Setup difficultyAdvanced
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
Docker
gitlab/gitlab-ee
Install with Linux

What 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

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

GitLab

Canonical source

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.

Free trial

You can request a free trial of GitLab Ultimate on our website.

How to install GitLab-CE

Install GitLab-CE with Linux

The recommended way to install GitLab is with the Omnibus packages on our package server. Compared to a self-compiled installation, this is faster and less error prone. Just select your operating system, download the respective package (Debian or RPM) and install it using the system's package manager.

Packages for Ubuntu, Debian, AlmaLinux, Oracle Linux, Red Hat Enterprise Linux, Amazon Linux and SUSE/openSUSE, in amd64/x86_64 and arm64/aarch64. Raspberry Pi needs 64-bit Raspberry Pi OS from GitLab 18.0 (32-bit Raspbian ended at 17.11). A from-source build also works on Arch Linux, FreeBSD, Gentoo and macOS, but GitLab supports none of them, and Windows is not supported.

How to configure GitLab-CE

  • GITLAB_OMNIBUS_CONFIGEnvironment variable holding gitlab.rb configuration lines for the Docker container.
  • external_urlgitlab.rb setting with the valid public URL (and port) of the GitLab instance.
  • gitlab_rails['gitlab_shell_ssh_port']22gitlab.rb setting for the SSH port used for Git over SSH.
  • gitlab_rails['lfs_enabled']gitlab.rb setting that enables Git LFS support.

    values: true, false

  • gitlab_rails['initial_root_password']gitlab.rb setting used to seed the root password (for example read from a Docker secret).

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

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…