The Hop Orchestration Platform aims to facilitate all aspects of data and metadata orchestration.

Apache Hop aims to offer you a very stable user experience. Any feedback that you might have is welcome! If you find that something is not working, have an idea for a new feature or simply if something is not to your liking, let us know! Your help is invaluable.

There are various things you can do to help Hop continue moving forward quickly:

• Log bugs, request features in GitHub
• Ask questions in the mailing lists or GitHub Discussions
• Help us write or fix documentation (lot of opportunities)
• Translate Hop. See our i18n guide.
• help fix some sonar issues

Check our Contribution Guide and the Hop website for more information on how to contribute.

Required:

• OpenJDK Java 21 compiler. Make sure to update your JDK to the latest possible patch version.

Recommended:

• Maven 3.6.3 or higher

Verify Maven Java version: (should be Java 21 to compile properly without skipping tests)

mvn -version

Clone Hop to a local repository:

$ git clone https://github.com/apache/hop.git

Change into the clone repository and build:
We provide two ways to build the code, if you have the correct Maven version installed you can use following commands:

$ cd hop 
$ mvn clean install 

We have also added mavenwrapper which simplifies build by using the correct Apache Maven version when it is not available on the system

$ cd hop
$ ./mvnw clean install

You can download a source release here

Required:

• OpenJDK Java 21 compiler or higher. Make sure to get the latest updates to support recent features like dark mode on the various platforms.
• Maven 3.6.3 or higher

Verify Maven Java version: (should be Java 21 to compile properly without skipping tests)

mvn -version

Unzip the archive

$ tar -xf apache-hop*.tar.gz

Change into the clone repository and build:
We provide two ways to build the code, if you have the correct Maven version installed you can use following commands:

$ cd apache-hop-*
$ mvn clean install

We have also added mavenwrapper which simplifies build by using the correct Apache Maven version when it is not available on the system

$ cd apache-hop-*
$ ./mvnw clean install

After a successful build, the Hop UI can be started.

$ cd assemblies/client/target
$ unzip hop-client-*.zip
$ cd hop 

On Windows, run hop-gui.bat, on Mac and Linux, run hop-gui.sh

Help us to improve Hop by logging issues in GitHub Issues

This distribution includes cryptographic software. The country in which you currently reside may have restrictions on the import, possession, use, and/or re-export to another country, of encryption software. BEFORE using any encryption software, please check your country's laws, regulations and policies concerning the import, possession, or use, and re-export of encryption software, to see if this is permitted. See http://www.wassenaar.org for more information.

The Apache Software Foundation has classified this software as Export Commodity Control Number (ECCN) 5D002, which includes information security software using or performing cryptographic functions with asymmetric algorithms. The form and manner of this Apache Software Foundation distribution makes it eligible for export under the "publicly available" Section 742.15(b) exemption (see the BIS Export Administration Regulations, Section 742.15(b)) for both object code and source code.

The following provides more details on the included cryptographic
software:

• PGP Encrypt - Decrypt transforms/actions
• Apache Kafka Transforms
• Apache POI Transforms
• MQTT Transforms