Docker

We provide pre-built docker images to quickly launch Axelor Open Suite in secure isolated container environment.

Prerequisite

Install Docker on your system. Please follow the official installation documentation for detailed installation guide.

Run the image

You can use production ready pre-built docker image like this:

$ docker run -it -p 8080:80 axelor/aio-erp

Once, application initialization is complete, you can access the application at: http://localhost:8080

Run with SSL

If you want to use https, provide SSL certificates like this:

$ docker run -it \
    -v /path/to/certs:/etc/nginx/certs \
    -p 80:80 \
    -p 443:443 \
    axelor/aio-erp

The certs directory should have following files:

  • certs/nginx.key - certificate key

  • certs/nginx.crt - certificate file

  • certs/dhparam.pem - DH parameters file

Run with base image

You can use your own axelor app with base docker image like this:

$ docker run -it \
  -v `pwd`/axelor-erp.war:/var/lib/tomcat/webapps/ROOT.war \
  -p 8080:80 axelor/aio-base

or with SSL like this:

$ docker run -it \
    -v `pwd`/certs:/etc/nginx/certs:ro \
    -v `pwd`/axelor-erp.war:/var/lib/tomcat/webapps/ROOT.war \
    -p 80:80 \
    -p 443:443 axelor/aio-base

Assuming you have axelor-erp.war and optionally SSL certs under certs directory of the current working directory. If not, replace `pwd` with the actual path.

Other Configuration

The docker image exposes following ports:

  • 80 - nginx http port

  • 443 - nginx https port

  • 8080 - tomcat http port

  • 5432 - postgresql port

The docker image exposes following volumes:

  • /var/lib/tomcat - tomcat base directory

  • /var/lib/postgresql - postgresql data directory

  • /var/log/tomcat - tomcat log files

  • /var/log/postgresql - postgresql log files

Following environment variables can be used to change container settings:

  • NGINX_HOST - the public host name (default: localhost)

  • NGINX_PORT - the public port (default: 443)

  • POSTGRES_USER - the postgresql user name (default: axelor)

  • POSTGRES_PASSWORD - the postgresql user password (default: axelor)

  • POSTGRES_DB - the postgresql database name (default: axelor)