Download and install Hop
Hop is designed to be as easy and accessible to use as possible. There is no installer and no server to set up: download, unzip, start.
Check your Java
Hop is self-contained. The only thing it needs is a Java runtime.
The official Java version for Hop is 21.
java -version
You should see something like:
openjdk version "21.0.10" 2026-01-20
OpenJDK Runtime Environment (build 21.0.10)
OpenJDK 64-Bit Server VM (build 21.0.10, mixed mode, sharing)
If that command is not found, or reports an older version, install a Java 21 runtime first. See Supported Java Versions for which runtimes are known to work, and which one to avoid.
Download and unzip
Download the client from the Apache Hop downloads page and unzip it to a folder of your choice.
That folder is your Hop installation. Everything you need is in it:
| What | Where |
|---|---|
The launcher scripts |
|
Configuration |
|
Plugins |
|
Projects created for you |
|
One step worth doing now
By default Hop keeps its configuration inside the installation folder. That means an upgrade - a new unzip - leaves your projects and settings behind in the old folder.
Point Hop at a user-level configuration folder instead, once, before you start:
-
Windows
-
Linux, macOS
hop.bat setup apply --defaults
./hop setup apply --defaults
Restart Hop afterwards. You can do the same thing from the GUI later with Tools → Configure Hop environment….
See Hop Setup for what it changes and how to undo it.
Start Hop Gui
-
Windows
-
Linux, macOS
hop-gui.bat
./hop-gui.sh
The first start takes a little longer than the ones after it, because Hop scans and registers its plugins.
Other ways to run Hop
Unzipping the client is the right way to start, but it is not the only option:
| Option | When you’d use it | Read more |
|---|---|---|
Docker - |
Running pipelines and workflows in a container, and Hop Server. This is how most production deployments run. |
|
Docker - |
Hop Gui in a browser, for shared or hosted development environments. |
|
Hop Web |
The same Hop Gui, running in a browser instead of on your desktop. |
| Installation and Configuration covers system requirements, memory settings and the environment variables Hop reads at startup. |
Now that Hop is running, let’s look at the words Hop uses for things.