solopcloud/adempiere-base repository overview

⁠Quick reference

• Mantained by: SOLOP⁠
• Where to get help: Gitter community ADempiere⁠, Git Project Adempiere⁠

⁠Supported tags and respective Dockerfile links

• tomcat, tomcat-alpine, latest ⁠

⁠What is ADempiere?

The ADempiere project was created in September 2006 after a long running disagreement between ComPiere Inc.⁠, the developers of Compiere™, and the community that formed around that project. The community believed Compiere Inc. placed too much emphasis on the open source lock-in/commercial nature of the project, rather than the community sharing/enriching nature of the project, and after an impassioned discussion decided to split from Compiere™ giving birth to the ADempiere project.

⁠What is ADempiere - Base?

This is an docker image for Adempiere ERP

⁠How to use this image

adempiere-base requires access to a PostgreSQL database to store information. We'll use the adempiere-postgres Docker Image for the database requirements.

⁠Run the application using Docker Compose

The main folder of this repository contains a functional docker-compose.yml file. Run the application using it as shown below:

$ curl -sSL https://raw.githubusercontent.com/solop-develop/adempiere-box/experimental/docker/docker-compose.yml > docker-compose.yml
$ docker-compose up -d

⁠Using stack deploy or docker-compose

⁠Download a stack file

$ curl -sSL https://raw.githubusercontent.com/solop-develop/adempiere-box/experimental/docker/stack.yml > stack.yml

⁠For run use:

$ docker stack deploy -c stack.yml adempiere

⁠Or:

$ docker-compose -f stack.yml up

Wait for it to initialize completely, and visit http://swarm-ip:8888, http://localhost:8888, or http://host-ip:8888 (as appropriate).

⁠Using the Docker Command Line

If you want to run the application manually instead of using docker-compose, these are the basic steps you need to run:

⁠Step 1: Create a network

$ docker network create adempiere-network

⁠Step 2: Create a PostgreSQL container

$ docker run --name adempiere-database \ 
-p 5432:5432 \
-e POSTGRES_PASSWORD=mysecretpassword \ 
-e DB_NAME=adempiere \
-e ADEMPIERE_PASSWORD=adempiere \
--network adempiere-network
-d solopcloud/adempiere-postgres 

⁠Start an adempiere-base instance

docker run --name adempiere-application \  
-p 8888:8888 
-e ADEMPIERE_DB_HOST=adempiere-database \
-e  ADEMPIERE_DB_NAME=adempiere \
-e ADEMPIERE_DB_PASSWORD=adempiere \
-e ADEMPIERE_DB_ADMIN_PASSWORD=mysecretpassword \ 
--network adempiere-network
-d solopcloud/adempiere-base

Access your application at http://your-ip:8888/⁠

⁠Configuration

⁠Initializing a new instance

When the container is executed for the first time, it will execute the file /opt/entrypoint.sh

⁠Environment variables

• ADEMPIERE_DB_TYPE: Database Type (Supported Oracle, PostgreSQL and MariaDB). Default PostgreSQL
• ADEMPIERE_DB_HOST: Hostname for PostgreSQL server. Default: localhost
• ADEMPIERE_DB_PORT: Port used by PostgreSQL server. Default: 5432
• ADEMPIERE_DB_NAME: Database name that Adempiere will use to connect with the database. Default: adempiere
• ADEMPIERE_DB_USER: Database user that Adempiere will use to connect with the database. Default: adempiere
• ADEMPIERE_DB_PASSWORD: Database password that Adempiere will use to connect with the database. Default: adempiere
• ADEMPIERE_DB_ADMIN_PASSWORD: Database root password that Adempiere will use to connect with the database. Default: postgres
• ADEMPIERE_WEB_PORT: Port to access Adempiere from outside of the container using HTTP. Used to configure Adempiere internal routes. Default: 8888
• ADEMPIERE_SSL_PORT: Port to access Adempiere from outside of the container using HTTPS. Used to configure Adempiere internal routes. Default: 4443
• ADEMPIERE_JAVA_OPTIONS: Additional java options to execute application. Default: -Xms128m -Xmx1024m
• ADEMPIERE_HOME: Directory of application. Default: /opt/Adempiere