1 创建项目目录

mkdir -p ~/gerrit && cd ~/gerrit

2 编写 docker-compose.yml

把下面内容保存为 docker-compose.yml；已默认挂载本地路径、开启 Web 界面，并配置好数据库。

services:
  gerrit:
    image: gerritcodereview/gerrit:3.13.0-ubuntu24
    ports:
      - "8080:8080"
      - "29418:29418"
    volumes:
      - gerrit_data:/var/gerrit
    environment:
      - CANONICAL_WEB_URL=http://localhost:8080
      - DATABASE_TYPE=postgresql
      - DB_PORT_5432_TCP_ADDR=db
      - DB_PORT_5432_TCP_PORT=5432
      - DB_ENV_POSTGRES_DB=gerrit
      - DB_ENV_POSTGRES_USER=gerrit
      - DB_ENV_POSTGRES_PASSWORD=gerrit
    depends_on:
      - db
    networks:
      - gerrit-net

  db:
    image: postgres:15-alpine
    environment:
      POSTGRES_DB: gerrit
      POSTGRES_USER: gerrit
      POSTGRES_PASSWORD: gerrit
    volumes:
      - postgres_data:/var/lib/postgresql/data
    networks:
      - gerrit-net

volumes:
  gerrit_data:
  postgres_data:

networks:
  gerrit-net:

3 启动

docker compose up -d

首次会拉取镜像并初始化，结束后可访问 Web 界面。

4 验证

• 浏览器打开 http://localhost:8080

• 默认管理员账号：admin
  首次登录会提示注册，按界面引导即可。

查看日志：

docker compose logs -f gerrit

5 常用运维命令

# 初次启动容器
docker compose up -d

# 停止容器
docker compose stop
# 启动容器
docker compose start

# 重启容器
docker compose restart gerrit

# 停止并删除容器
docker compose down

# 停止并删除容器并删除数据
docker compose down -v

# 升级镜像
docker compose pull
docker compose up -d

# 进入容器（以root权限）
docker compose exec -u root gerrit bash
# 在容器中安装vim
# yum install vim -y

# 进入日期（以gerrit用户）
docker compose exec gerrit bash

6 生产环境

• 数据库：把 DATABASE_TYPE 换成 postgresql 并指向外部高可用 PG。

• LDAP：在 ./gerrit/etc/gerrit.config 中追加 [ldap] 段，重启容器即可

• HTTPS：前置 Nginx 或 Traefik 做反向代理，证书托管用 Let’s Encrypt。

• 备份：定期对 ./gerrit 目录与 postgres_data 做快照。

至此，Ubuntu 24.04 上通过 docker compose 运行 Gerrit 完成，可开始创建项目、配置评审流程。