Installation

To set up H2O Wave, simply download and extract a release (~10MB). The release ships with a precompiled binary executable, so no explicit installation step is necessary.

Prerequisites

H2O Wave runs on Linux, macOS, and Windows, having Python 3.6+.

Setup

Step 1: Download

Download the H2O Wave SDK for your platform.

Step 2: Extract

Extract your download.

tar -xzf wave-x.y.z-linux-amd64.tar.gz

Step 3: Move

Move it to a convenient location, say $HOME/wave/.

mv wave-x.y.z-linux-amd64 $HOME/wave
note

If you have a previous version of Wave installed, be sure to remove it before installing another. To remove it, simply delete the previous directory.

Inspect your $HOME/wave directory. You should see the following content:

.
โ”œโ”€โ”€ examples/ ... Examples
โ”œโ”€โ”€ test/ ... Browser testing framework
โ”œโ”€โ”€ www/ ... Wave server web root (do not modify!)
โ””โ”€โ”€ waved ... Wave server executable

Step 4: Run

Go to your Wave directory.

cd $HOME/wave

Start the Wave server.

./waved
2020/10/27 16:16:34 #
2020/10/27 16:16:34 # โ”Œโ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”
2020/10/27 16:16:34 # โ”‚ โ”Œ โ”Œ โ”Œโ”€โ”€โ” โ”Œ โ”Œ โ”Œโ”€โ”€โ” โ”‚ H2O Wave
2020/10/27 16:16:34 # โ”‚ โ”‚ โ”Œโ”€โ”€โ”˜ โ”‚โ”€โ”€โ”‚ โ”‚ โ”‚ โ””โ” โ”‚ (version) (build)
2020/10/27 16:16:34 # โ”‚ โ””โ”€โ”˜ โ”˜ โ”˜ โ””โ”€โ”€โ”˜ โ””โ”€โ”˜ โ”‚ ยฉ 2020 H2O.ai, Inc.
2020/10/27 16:16:34 # โ””โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”˜
2020/10/27 16:16:34 #
2020/10/27 16:16:34 # {"address":":10101","t":"listen","webroot":"/home/elp/wave/www"}
info

On Windows, run waved.exe to start the server.

Step 5: Verify

Finally, point your web browser to http://localhost:10101/. You should see an empty page with a blinker that looks like this:

blinker

Congratulations! Wave is now running, but doesn't have any content yet (hence the spinner).

In the next few sections, we'll add some content and see what the fuss is all about.