solopcloud/adempiere-proxy repository overview

⁠Quick reference

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

⁠Supported tags and respective Dockerfile links

• 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 - Proxy?

A simple proxy for synchronize ADempiere Backend based on ADempiere-gRPC-Server with any frontend using api REST and GraphQL.

⁠How to use this image

adempiere-proxy requires access to a Adempiere - Backend. We'll use the adempiere-backend Docker Image for the backend 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/proxy-adempiere-api/experimental-1.0.1/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/proxy-adempiere-api/experimental-1.0.1/docker/stack.yml > stack.yml

⁠For run use:

$ docker stack deploy -c stack.yml adempiere-api

⁠Or:

$ docker-compose -f stack.yml up

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

⁠Configuration

⁠Initializing a new instance

When the container is executed for the first time, it will execute the file start.sh

⁠Environment variables

• SERVER_PORT: Port to access Adempiere Proxy from outside of the container using HTTP. Used to configure Adempiere internal routes. Default: 8085
• ES_HOST: Hostname for Elastic Search server. Default: localhost
• ES_PORT: Port used by Elastic Search server. Default: 9200
• REDIS_HOST: Hostname for Redis server. Default: localhost
• REDIS_PORT: Port used by Redis server. Default: 6379
• REDIS_DB: Database name that Adempiere Proxy will use to connect with the Redis database. Default: 0 -AD_DEFAULT_HOST: Adempiere GRPC Backend Hostname. Default: localhost
• AD_DEFAULT_PORT:Adempiere GRPC Backend Port number. Default: 50059
• AD_TOKEN: Adempiere Token. Default: adempiere_token
• AD_STORE_TOKEN: Adempiere Token for store. Default: adempiere_store_token
• API_URL_IMAGES: Adempiere Proxy URL. Default: localhost
• STORE_URL_IMAGES: Adempiere Proxy URL for Images. Default: localhost
• RESTORE_DB: Restore Database? . Default: NO
• INDEX: Index for Catalog. Default: vue_storefront_catalog
• LANGUAGE: Languague. Default: en_US