digitalfiends / hermes

Hermes Messaging Gateway

Hermes Business Messaging Gateway is a proven open-source solution for enterprises to automate business transactions with business partners through secure and reliable exchange of electronic documents (e.g., purchase orders). Hermes is secure; it allows you to encrypt and digitally sign the documents for transmission. Hermes is reliable; the sender can automatically retransmit a message when it is dropped in the network while the receiver can guarantee every message is delivered once and only once, and in the right order.

Table of Contents

Documentations
Quick Start
Development

Documentation

Full documentation is available at hermes.cecid.org.

Quick Start

Install Hermes with Docker

1. Install the Docker Engine.

2. Run the Docker container for Hermes database (MySQL).
   docker run --name hermes_db -e MYSQL_ROOT_PASSWORD=corvus -d cecid/hermes_db:2.2

3. Run the Docker container for Hermes application server (Tomcat).
   docker run --name hermes_app --link hermes_db:db -p 8080:8080 -d cecid/hermes_app:2.2

4. Log in to the Hermes administration console at http://localhost:8080/corvus/admin/home (username:corvus, password:corvus) to check if Hermes is up and running.

Development

Compile

1. Install Apache Maven
2. Execute processes needed prior to actual project build.
   mvn pre-clean
3. Compile Hermes and build JAR installer file.
   mvn install
4. Locate hermes2_installer.jar under the target/ directory. Install Hermes following the installation guide.

Java API Documentations

The Java API Documentations are available at javadocs.hermes.cecid.org

Digital Signature Setup

Please refer to How to send messages using Self Signed Certificate.