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.


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


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

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.

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, 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"}

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:


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.