H2O.ai Quick Installation Guide



H2O.ai is a machine learning platform that makes building ML models easier, thanks in part to its really easy to use interface H2OFlow. This guide will make installing H2O just as easy as using it.

If you want a quick way of using H2O and many other frameworks without any hassle, try our free AMI on AWS called It’s Not That Deep where you can get a deep learning stack with H2O, Tensorflow, CUDA, PyTorch, and more, all pre-installed. Check it out.


Make sure you have an Ubuntu server setup prior to starting this guide. If you’re unsure how to do that, we have a guide to setting up AWS instances here.

For this guide, we’re using a t3.2xlarge instance on AWS with 8 vCpus, 32 gb of Ram, and 100gb of storage running the Ubuntu 18.04 AMI, but you can use any type of instance you like.

We do, however, recommend that the instance you use has at least 4gb of ram, 2 vCpus, and 30 gb of storage.

You can also install it locally, however, we recommend using an external server for this.

To Do List:

  • Login to Server.

  • Update APT.

  • Install JDK.

  • Install UNZIP.

  • Install H2O.

  • Launch and Test H2OFlow.

Install Guide:

Step 1:

Open up terminal.

cd into the folder with your your key pair.

You will need your key pair, your public dns, and your user name.

Your user name will vary depending on the AMI you are using. Since we’re using Ubuntu our user name is Ubuntu. Checkout our Easy Launch Guide to AWS and EC2 Instances if you don’t know what your username could be.

We will be using localhost tunneling to make sure that we can launch H2O on our browsers, this is the -L argument for ssh.

Use the command: ssh -i YOUR_KEY_NAME.PEM -L 54321:localhost:54321 USERNAME@YOUR-PUBLIC.DNS.COM

If you get a popup asking you to identify the host, make sure the DNS in your terminal matches the DNS on AWS and enter “yes”.

Screen Shot 2019-03-26 at 5.32.22 PM.png

Step 2:

Use the command: sudo apt update

This command updates your package lists.

Circle Launch VM.png

Step 3:

Use the command: sudo apt install default-jdk

This installs the default Java Development Kit. H2O runs on Java, so this step is essential. It may take from 1-20 minutes depending on your internet connection.

Use the command: sudo apt install unzip

This installs the unzip tool which will be used to unzip H2O later.

Screen Shot 2019-03-26 at 5.38.14 PM.png

Step 4:

Open up your browser.

Go to the official H2O.ai webpage, go to downloads, and click “latest stable release” for H2O. You should end up here.

Right click the “Download H2O” button and click “copy link address”.


Step 5:

Go back to your terminal window.

Use the command: wget insert.your.h2o.link.here

Screen Shot 2019-03-26 at 5.53.34 PM.png

Step 6:

Use the command: ls

This lists all of the files in the current directory.

Find the file that looks like “h2o-” with the version number corresponding to your version.

Use the command: unzip h2o-yourversion.zip

This will unzip your h2o archive.

Screen Shot 2019-03-26 at 5.57.13 PM.png

Step 7:

**Optional Step** You can rename your h2o folder to just “h2o” by running: mv h2o-current-version h2o

This makes it easier to access the folder later.

Step 8:

Time to test and see if the install worked.

Use the command: cd h2o

Replace h2o with the name of your h2o folder.

Use the command: java -jar h2o.jar

This command launches H2O.ai.

Screen Shot 2019-03-26 at 6.02.54 PM.png

Step 9:

After it runs go back into your browser and head to this url: localhost:54321

If you get this screen, congrats! You have successfully installed H2O!

Screen Shot 2019-03-26 at 6.04.56 PM.png


  • If you don’t see anything when you go to localhost:54321:

    • Check to make sure that you forwarded the port correctly in Step 1.

    • Check to make sure that the terminal has successfully finished loading H2O.

    • Check to make sure there’s nothing already running on port 54321.

    • Check to make sure there is a h2o.jar file in that directory using ls.

  • If you can’t install default-jdk:

    • Make sure you are using Ubuntu 18.04.

    • Make sure you ran sudo apt update prior to trying to install default-jdk.

    • If installing locally, make sure you’re connected to the internet.

  • If you’re having trouble finding your h2o directory:

    • Follow these Steps:

      • Run cd.

      • Run ls to see all of the files in the directory.

      • Find the folder starting with “h2o” and ending with your version number.

Check out the h2o documentation if you have any other issues.