Get Started

A Crash Course in Deephaven is your backpack guide through the world of real-time data analysis using the Deephaven data engine.

This crash course provides a broad, clear, and technically informative overview of Deephaven's capabilities. Let's dive in and unlock the potential of this powerful platform.

This first chapter gets a Deephaven server running and opens the Deephaven IDE, where you run the code for the rest of the crash course.

Start Deephaven

To follow along, ensure you have Docker installed on your machine.

Once Docker is installed, run this command:

Caution

Replace YOUR_PASSWORD_HERE with a secure password of your own to keep your session safe. Deephaven uses this password as its pre-shared key to authenticate you.

The server keeps running in this terminal and prints its log there. When the log shows Server started on port 10000, the server is ready.

The command's options do the following:

  • -p 10000:10000 makes the container's port 10000 available on your machine, so you can open the IDE at http://localhost:10000/ide/ in Open the IDE.
  • --env START_OPTS=... passes your password to the server as a startup option. The Configure your Deephaven instance chapter near the end of this crash course uses START_OPTS to set other options, such as the server's maximum Java heap size.
  • -v "$(pwd)/data:/data" mounts a data directory from your current working directory at /data in the container. Docker creates the directory if it doesn't exist.
  • --rm deletes the container when it stops.
  • --name deephaven names the container deephaven, so you can refer to it by name in other Docker commands, such as docker stop deephaven.

Files you save in the IDE go to data/storage on your machine. Anything your code writes under /data in the container also appears in your local data directory. Because these files live on your machine, you won't lose your work when --rm deletes the container. To learn more about mounting directories in Docker, see Docker data volumes.

Get the example data

The Data I/O chapter reads Deephaven's example datasets from /data/examples in the container. To download the Deephaven examples into your local data/examples directory, open a second terminal in the same directory and run:

Open the IDE

Open the Deephaven IDE at http://localhost:10000/ide/, enter your password in the Token field, and you're ready to go!

Once you're in, the Console on the left is where you write and run code. Results, such as tables and plots, open as panels in the workspace. The Panels menu at the top right of the IDE lists the tables, plots, and other objects in your session. Select one to open it. See Navigate the GUI for a full tour of the interface.

Next, Architecture overview explains how Deephaven's tables, engine, and user interface fit together.