注意： 这是 redmine 镜像 的 i386 架构构建的“按架构”仓库 — 更多信息，请参阅镜像文档中的 "除 amd64 之外的架构？" 和***镜像常见问题中的 "Git 中镜像的源代码已更改，现在该怎么办？"。

快速参考

-** 维护者：**Docker 社区

-** 寻求帮助：**Docker 社区 Slack、Server Fault、Unix & Linux 或 Stack Overflow

支持的标签及对应的 Dockerfile 链接

• 6.1.0, 6.1, 6, latest, 6.1.0-trixie, 6.1-trixie, 6-trixie, trixie

• 6.1.0-alpine3.22, 6.1-alpine3.22, 6-alpine3.22, alpine3.22, 6.1.0-alpine, 6.1-alpine, 6-alpine, alpine

• 6.1.0-alpine3.21, 6.1-alpine3.21, 6-alpine3.21, alpine3.21

• 6.0.7, 6.0, 6.0.7-trixie, 6.0-trixie

• 6.0.7-bookworm, 6.0-bookworm

• 6.0.7-alpine3.22, 6.0-alpine3.22, 6.0.7-alpine, 6.0-alpine

• 6.0.7-alpine3.21, 6.0-alpine3.21

• 5.1.10, 5.1, 5, 5.1.10-trixie, 5.1-trixie, 5-trixie

• 5.1.10-bookworm, 5.1-bookworm, 5-bookworm

• 5.1.10-alpine3.22, 5.1-alpine3.22, 5-alpine3.22, 5.1.10-alpine, 5.1-alpine, 5-alpine

• 5.1.10-alpine3.21, 5.1-alpine3.21, 5-alpine3.21

快速参考（续）

-** 提交问题：[*]

-** 支持的架构：**(更多信息) amd64、arm32v5、arm32v6、arm32v7、arm64v8、i386、mips64le、ppc64le、riscv64、s390x

-** 已发布镜像制品详情：**repo-info 仓库的 repos/redmine/ 目录 (历史记录)（镜像元数据、传输大小等）

-** 镜像更新：**official-images 仓库的 library/redmine 标签、official-images 仓库的 library/redmine 文件 (历史记录)

-** 本描述的来源：**docs 仓库的 redmine/ 目录 (历史记录)

什么是 Redmine？

Redmine 是一个免费开源的基于 Web 的项目管理和问题跟踪工具。它允许用户管理多个项目及相关子项目，具有每个项目的 Wiki 和论坛、时间跟踪以及灵活的基于角色的访问控制。它包含日历和甘特图，以帮助可视化项目及其截止日期。Redmine 与各种版本控制系统集成，并包含仓库浏览器和差异查看器。

***.org/wiki/Redmine

!logo

如何使用本镜像

使用 SQLite3 运行 Redmine

这是最简单的设置，只需运行 Redmine。

console
$ docker run -d --name some-redmine i386/redmine

不适用于多用户生产环境使用 (redmine 维基)

使用数据库容器运行 Redmine

推荐使用数据库服务器运行 Redmine。

1. 启动数据库容器

   • PostgreSQL

     console
     $ docker run -d --name some-postgres --network some-network -e POSTGRES_PASSWORD=secret -e POSTGRES_USER=redmine postgres
     

   • MySQL（运行 Redmine 时，将 -e REDMINE_DB_POSTGRES=some-postgres 替换为 -e REDMINE_DB_MYSQL=some-mysql）

     console
     $ docker run -d --name some-mysql --network some-network -e MYSQL_USER=redmine -e MYSQL_PASSWORD=secret -e MYSQL_DATABASE=redmine -e MYSQL_RANDOM_ROOT_PASSWORD=1 mysql:5.7
     

2. 启动 Redmine

   console
   $ docker run -d --name some-redmine --network some-network -e REDMINE_DB_POSTGRES=some-postgres -e REDMINE_DB_USERNAME=redmine -e REDMINE_DB_PASSWORD=secret i386/redmine
   

通过 docker compose

redmine 的 compose.yaml 示例：

yaml
services:

  redmine:
    image: redmine
    restart: always
    ports:
      - 8080:3000
    environment:
      REDMINE_DB_MYSQL: db
      REDMINE_DB_PASSWORD: example
      REDMINE_SECRET_KEY_BASE: supersecretkey

  db:
    image: mysql:8.0
    restart: always
    environment:
      MYSQL_ROOT_PASSWORD: example
      MYSQL_DATABASE: redmine

运行 docker compose up，等待其完全初始化，然后访问 http://localhost:8080 或 [***]（视情况而定）。

访问应用程序

当前，上游的默认用户名和密码为 admin/admin（登录应用程序）。

数据存储位置

重要说明：有多种方式存储 Docker 容器中运行的应用程序所使用的数据。我们建议 redmine 镜像的用户熟悉可用选项，包括：

• 让 Docker 通过使用其自己的内部卷管理将文件写入主机系统的磁盘来管理文件存储。这是默认选项，对用户而言简单且相当透明。缺点是对于直接在主机系统上运行的工具和应用程序（即容器外部），文件可能难以定位。
• 在主机系统上（容器外部）创建数据目录，并将其挂载到容器内可见的目录。这将数据库文件放置在主机系统上的已知位置，便于主机系统上的工具和应用程序访问文件。缺点是用户需要确保目录存在，并且主机系统上的目录权限和其他安全机制设置正确。

Docker 文档是了解不同存储选项和变体的良好起点，有许多博客和论坛帖子讨论此领域并提供建议。我们在此仅展示上述后一种选项的基本步骤：

1. 在主机系统的合适卷上创建数据目录，例如 /my/own/datadir。

2. 像这样启动 redmine 容器：

   console
   $ docker run -d --name some-redmine -v /my/own/datadir:/usr/src/redmine/files --link some-postgres:postgres i386/redmine
   

命令中的 -v /my/own/datadir:/usr/src/redmine/files 部分将底层主机系统的 /my/own/datadir 目录挂载为容器内的 /usr/src/redmine/files，Redmine 将在此存储上传的文件。

端口映射

如果希望无需容器 IP 即可从主机访问实例，可以使用标准端口映射。只需将 -p 3000:3000 添加到 docker run 参数，然后在浏览器中访问 http://localhost:3000 或 [***]。

环境变量

启动 redmine 镜像时，可以通过在 docker run 命令行上传递一个或多个环境变量来调整实例配置。

REDMINE_DB_MYSQL、REDMINE_DB_POSTGRES 或 REDMINE_DB_SQLSERVER

这些变量允许您分别设置 MySQL、PostgreSQL 或 Microsoft SQL 主机的主机名或 IP 地址。这些值互斥，若设置两个则行为未定义。若未设置任何变量，镜像将回退使用 SQLite。

REDMINE_DB_PORT

此变量允许您指定自定义数据库连接端口。若未指定，将默认为常规连接端口：MySQL 为 3306，PostgreSQL 为 5432，SQLite 为空字符串。

REDMINE_DB_USERNAME

此变量设置 Redmine 和任何 rake 任务用于连接到指定数据库的用户。若未指定，MySQL 默认为 root，PostgreSQL 默认为 postgres，SQLite 默认为 redmine。

REDMINE_DB_PASSWORD

此变量设置指定用户连接数据库时使用的密码。无默认值。

REDMINE_DB_DATABASE

此变量设置 Redmine 在指定数据库服务器中使用的数据库。若未指定，MySQL 默认为 redmine，PostgreSQL 默认为 REDMINE_DB_USERNAME 的值，SQLite 默认为 sqlite/redmine.db。

REDMINE_DB_ENCODING

此变量设置连接数据库服务器时使用的字符编码。若未指定，MySQL 将使用 mysql2 库的默认值（UTF-8），PostgreSQL 为 utf8，SQLite 为 utf8。

REDMINE_NO_DB_MIGRATE

此变量允许您控制容器启动时是否运行 rake db:migrate。只需将变量设置为非空字符串（如 1 或 true），迁移脚本将不会在容器启动时自动运行。

如果您使用默认 CMD 以外的命令（如 bash）启动镜像，db:migrate 也不会运行。有关详细信息，请参阅镜像中的当前 docker-entrypoint.sh。

REDMINE_PLUGINS_MIGRATE

此变量允许您控制容器启动时是否运行 rake redmine:plugins:migrate。只需将变量设置为非空字符串（如 1 或 true），迁移脚本将在每次容器启动时自动运行，并在 db:migrate 之后执行。

如果您使用默认 CMD 以外的命令（如 bash）启动镜像，redmine:plugins:migrate 也不会运行。有关详细信息，请参阅镜像中的当前 docker-entrypoint.sh。

SECRET_KEY_BASE

这是一个常规的 Rails 环境变量。在使用负载均衡副本维护会话连接时此变量很有用。它“被 Rails 用于编码存储会话数据的 cookie，从而防止篡改。生成新的密钥令牌会在重启后使所有现有会话失效”（会话存储）。若未设置此变量，secret_key_base 值将使用 rake generate_secret_token 生成。

为保持向后兼容性，已弃用的 Docker 特定变量 REDMINE_SECRET_KEY_BASE 将自动填充 SECRET_KEY_BASE 环境变量。用户应迁移其部署以直接使用 SECRET_KEY_BASE 变量。

Docker Secrets

作为通过环境变量传递敏感信息的替代方法，可以将上述环境变量附加 _FILE，使初始化脚本从容器中存在的文件加载这些变量的值。特别是，这可用于从存储在 /run/secrets/<secret_name> 文件中的 Docker Secrets 加载密码。例如：

console
$ docker run -d --name some-redmine -e REDM