# Gitlab

Gitlab CE runs as a single Docker container on the `gitlab` host
(`10.0.1.14`), managed by Ansible (`deployments/gitlab/`).

## Install

1. Install Docker and the compose plugin on the host.
2. Create the `gitlab-data` volume: `docker volume create gitlab-data`.
3. Run the stack from `gitlab-compose.yaml`:
   `docker compose -f gitlab-compose.yaml up -d`
4. Wait ~2 minutes for the initial gitlab migration to finish.

## Access

- Web UI: https://gitlab.reeseapps.com (Traefik routes it to port 8929).
- Root password: `gitlab-root-password` file in the repo (rotated yearly).
- Backup: nightly `gitlab-backup create` at 03:30, copy to BorgBase.

## Operations

- Upgrade gitlab: bump the image tag in the compose file,
  `docker compose up -d gitlab`, watch the logs for the version banner.
- Logs: `docker logs -f gitlab` or the gitlab admin area → Admin
  area → Logs.
- If the container is OOM-killed, raise the memory limit in the compose
  file (it needs 4GB free).