idempiereofficial/idempiere

iDempiere Docker镜像文档

快速参考

• 维护者：
  INGEINT

• 获取帮助：
  iDempiere社区论坛 或 Mattermost支持频道

• 提交问题：
  Mattermost支持频道 或 https://github.com/idempiere/idempiere-docker/issues

• 官方链接：
  https://hub.docker.com/r/idempiereofficial/idempiere, https://github.com/idempiere/idempiere-docker, https://github.com/idempiere/idempiere

支持的标签及对应Dockerfile链接

iDempiere（生产环境）

生产级iDempiere环境

• https://github.com/idempiere/idempiere-docker/tree/master/daily
• https://github.com/idempiere/idempiere-docker/tree/master/7.1
• https://github.com/idempiere/idempiere-docker/tree/master/8.2
• https://github.com/idempiere/idempiere-docker/tree/master/9
• https://github.com/idempiere/idempiere-docker/tree/master/10
• https://github.com/idempiere/idempiere-docker/tree/master/11
• https://github.com/idempiere/idempiere-docker/tree/master/12

iDempiere源码（开发环境）

iDempiere源代码开发环境

• https://github.com/idempiere/idempiere-docker/tree/master/source-master
• https://github.com/idempiere/idempiere-docker/tree/master/source-release-7.1
• https://github.com/idempiere/idempiere-docker/tree/master/source-release-8.2
• https://github.com/idempiere/idempiere-docker/tree/master/source-release-9
• https://github.com/idempiere/idempiere-docker/tree/master/source-release-10
• https://github.com/idempiere/idempiere-docker/tree/master/source-release-11
• https://github.com/idempiere/idempiere-docker/tree/master/source-release-12

什么是iDempiere？

iDempiere是一款功能强大的开源ERP/CRM/SCM系统，由专业社区支持。该项目专注于高质量软件、开放协作理念，社区成员包括领域专家、实施者、开发者和最终用户。

iDempiere以其高质量架构设计、可靠性、丰富功能集、可扩展性以及开源社区持续开发创新解决方案的承诺而享有盛誉。

更多信息请参见官方网站。

快速开始

使用Docker命令

iDempiere Docker需PostgreSQL管理员密码和用户创建数据库，示例中POSTGRES_PASSWORD=postgres，如需其他配置请参见环境变量：

bash
$ docker run -d --name postgres -p 5432:5432 -e POSTGRES_PASSWORD=postgres postgres:16

如已运行PostgreSQL，请修改端口，例如-p 5433:5432。
可使用前置要求页面中支持的任意PostgreSQL版本。

bash
$ docker run -d --name idempiere -p 8443:8443 --link postgres:postgres idempiereofficial/idempiere:12-master

如需持久化数据，请参见卷部分。

容器自动启动配置参见https://docs.docker.com/config/containers/start-containers-automatically/%E3%80%82

在浏览器中访问：[***]

注意：iDempiere 9及以上版本不再支持直接HTTP访问。详情参见迁移说明。

Linux下使用外部数据库

bash
$ docker run -d --name idempiere -p 8443:8443 --network host\
  -e DB_HOST=127.0.0.1\
  -e DB_PORT=5432\
  -e DB_NAME=idempiere\
  -e DB_USER=adempiere\
  -e DB_PASS=adempiere\
  -e DB_ADMIN_PASS=postgres\
  idempiereofficial/idempiere:12-master

Windows系统使用^符号换行

bash
$ docker run -d --name idempiere -p 8443:8443 ^
  -e DB_HOST=0.0.0.0 ^
  -e DB_PORT=5432 ^
  -e DB_NAME=idempiere ^
  -e DB_USER=adempiere ^
  -e DB_PASS=adempiere ^
  -e DB_ADMIN_PASS=postgres ^
  idempiereofficial/idempiere:12-master

敏感信息管理参见Docker Secrets。

使用Docker Stack（Docker Swarm或Docker Compose）

创建docker-stack.yml文件：

yaml
version: '3.7'

services:
  idempiere:
    image: docker.xuanyuan.run/idempiereofficial/idempiere:12-master
    volumes:
      - idempiere_config:/opt/idempiere/configuration
      - idempiere_plugins:/opt/idempiere/plugins
    environment:
      - TZ=America/Caracas
    ports:
      - 8080:8080
      - 8443:8443
      - 12612:12612

  postgres:
    image: docker.xuanyuan.run/postgres:16
    volumes:
      - idempiere_data:/var/lib/postgresql/data
    environment:
      - TZ=America/Caracas
      - POSTGRES_PASSWORD=postgres
    ports:
      - 5432:5432

volumes:
  idempiere_data:
  idempiere_plugins:
  idempiere_config:

Docker Swarm部署：

bash
$ docker stack deploy -c docker-stack.yml idempiere

Docker Compose部署：

bash
$ docker-compose -f docker-stack.yml up

默认账户

初始种子数据库包含以下用户和密码：

环境变量

默认端口

工作原理

iDempiere启动时会检查数据库是否存在，如不存在则创建种子数据库。

如数据库已存在，iDempiere不会自动迁移，需手动执行或设置MIGRATE_EXISTING_DATABASE=true。

启动前，将根据setup.sh或console-setup.sh文件配置所有设置，详见docker-entrypoint.sh。

本项目不支持Oracle数据库。

卷

PostgreSQL数据卷

Docker Stack配置：

yaml
volumes:
  - idempiere_data:/var/lib/postgresql/data

或在命令中添加：

bash
-v idempiere_data:/var/lib/postgresql/data

iDempiere插件和配置卷

Docker Stack配置：

yaml
volumes:
  - idempiere_config:/opt/idempiere/configuration
  - idempiere_plugins:/opt/idempiere/plugins

或在命令中添加：

bash
-v idempiere_config:/opt/idempiere/configuration -v idempiere_plugins:/opt/idempiere/plugins

idempiere_config存储插件配置，idempiere_plugins存放插件JAR文件（用于安装新插件）。

本地目录共享插件：

yaml
volumes:
  - idempiere_config:/opt/idempiere/configuration
  - ./plugins:/opt/idempiere/plugins

或命令中添加：

bash
-v idempiere_config:/opt/idempiere/configuration -v ./plugins:/opt/idempiere/plugins

iDempiere日志卷

Docker Stack配置：

yaml
volumes:
  - idempiere_log:/opt/idempiere/log

或命令中添加：

bash
-v idempiere_log:/opt/idempiere/log

调试模式运行

在YAML中添加command属性：

yaml
command: idempiere debug

或命令中添加：

bash
docker run -d --name idempiere -p 8443:8443 --link postgres:postgres docker.xuanyuan.run/idempiereofficial/idempiere:12-master idempiere debug

Docker Secrets

除环境变量外，可通过_FILE后缀从文件加载敏感信息，详见https://docs.docker.com/engine/swarm/secrets/%E5%92%8Chttps://hub.docker.com/_/postgres%E3%80%82

支持的变量列表：

示例：

创建密钥：

bash
$ printf "postgres" | docker secret create db_admin_pass -

在Stack文件中使用：

yaml
version: '3.7'

services:
  idempiere:
    image: docker.xuanyuan.run/idempiereofficial/idempiere:12-master
    environment:
      - TZ=America/Caracas
      - DB_ADMIN_PASS_FILE=/run/secrets/db_admin_pass
    secrets:
      - db_admin_pass
    ports:
      - 8080:8080
      - 8443:8443
      - 12612:12612

  postgres:
    image: docker.xuanyuan.run/postgres:16
    environment:
      - TZ=America/Caracas
      - POSTGRES_PASSWORD_FILE=/run/secrets/db_admin_pass
    secrets:
      - db_admin_pass
    ports:
      - 5432:5432

volumes:
  idempiere_data:

secrets:
  db_admin_pass:
    external: true

使用iDempiere源码镜像

源码镜像用于开发环境，标签对应iDempiere源码分支：

• https://github.com/idempiere/idempiere-docker/tree/master/source-master%EF%BC%9A%E5%AF%B9%E5%BA%94https://github.com/idempiere/idempiere/tree/master
• https://github.com/idempiere/idempiere-docker/tree/master/source-release-7.1%EF%BC%9A%E5%AF%B9%E5%BA%94https://github.com/idempiere/idempiere/tree/release-7.1
• https://github.com/idempiere/idempiere-docker/tree/master/source-release-8.2%EF%BC%9A%E5%AF%B9%E5%BA%94https://github.com/idempiere/idempiere/tree/release-8.2
• https://github.com/idempiere/idempiere-docker/tree/master/source-release-9%EF%BC%9A%E5%AF%B9%E5%BA%94https://github.com/idempiere/idempiere/tree/release-9
• https://github.com/idempiere/idempiere-docker/tree/master/source-release-10%EF%BC%9A%E5%AF%B9%E5%BA%94https://github.com/idempiere/idempiere/tree/release-10
• https://github.com/idempiere/idempiere-docker/tree/master/source-release-11%EF%BC%9A%E5%AF%B9%E5%BA%94https://github.com/idempiere/idempiere/tree/release-11
• https://github.com/idempiere/idempiere-docker/tree/master/source-release-12%EF%BC%9A%E5%AF%B9%E5%BA%94https://github.com/idempiere/idempiere/tree/release-12

源码镜像环境变量