Установка GitLab на свой сервер: термины и чек-лист

Подробности, цифры, термины и чек-лист по теме «Установка GitLab на свой сервер». Страница справочника целиком: Установка GitLab на сервер.

Коротко о теме

Установка GitLab на VPS через Docker Compose: образ gitlab-ce, 8 vCPU по документации, SSH на порту 2424, пароль root и порядок обновления.

Подробности по разделам

Что входит в GitLab и когда он нужен вместо Gitea

Если нужен только Git с веб-интерфейсом для небольшой группы, хватит лёгкого Gitea: он работает на сервере в разы меньше. Общее сравнение пяти Git-серверов: self hosted Git.

Домен, HTTPS и SSH для GitLab на своём сервере

Адрес в external_url при этом остаётся с https. В интерфейсе GitLab покажет адреса для клонирования уже с портом 2424. Для старых клиентов можно добавить запись в ~/.ssh/config, чтобы не печатать порт каждый раз.

Резервные копии и обновление GitLab в Docker

Восстановить архив можно только в ту же версию GitLab. Версии нельзя перепрыгивать Между крупными версиями GitLab есть обязательные остановки на пути обновления. Перед обновлением откройте upgrade path на сайте документации, сделайте архив и снимок сервера, затем меняйте тег образа и выполняйте docker compose up -d.

Ключевые цифры

Документация GitLab называет минимумом 16 ГБ для одного сервера, а для режима с экономией памяти 8 ГБ.
Поставить Docker, описать образ gitlab/gitlab-ce в compose-файле с тремя томами (config, logs, data), открыть порты 80, 443 и вынести SSH на 2424, затем выполнить docker compose up -d и дождаться конца первого старта.
На Windows его запускают в WSL2 или Docker Desktop только для проб; боевой сервер лучше держать на Linux VPS.

Термины на странице

SSH: SSH это защищённое подключение к серверу через командную строку. Вход по ключу безопаснее, чем по паролю.
Linux: Linux это семейство операционных систем для серверов: Ubuntu, Debian, AlmaLinux и другие.
Cron: Cron это планировщик задач в Linux: запускает скрипты по расписанию.
Let's Encrypt: Let's Encrypt выпускает бесплатные DV-сертификаты на 90 дней с автоматическим продлением.
Nextcloud: Nextcloud это облачное хранилище файлов, которое ставят на свой сервер.
n8n: n8n это программа для автоматизации: связывает сервисы сценариями без программирования.
A-запись: A-запись связывает домен с IPv4-адресом сервера.
Nginx: Nginx это веб-сервер и обратный прокси. Его часто ставят перед приложением, чтобы раздавать статику и держать HTTPS.

Что проверить

Выберите конфигурацию по памяти и диску под задачу, процессор обычно вторичен.
Проверьте тип виртуализации: KVM даёт свою систему и гарантированные ресурсы.
Уточните, входит ли IPv4 и сколько стоит трафик сверх пакета.
Храните данные контейнеров в томах.
Закрепляйте версии образов, а не latest.
Ограничьте ресурсы контейнеров, чтобы один не съел весь сервер.