Install and run the Deephaven production application

This guide shows you how to install and launch the Deephaven Community Core production application. The production application runs Deephaven from artifacts built for each release, so you don't need Docker or a source build. It is the recommended way to run production applications that use Deephaven, hence its name.

This guide covers installing and starting the server, setting authentication, and running more than one server on a machine. For more advanced options, see Configure the production application.

Supported operating systems

Deephaven runs on these operating systems. See the version matrix for which platforms Deephaven tests regularly and which it only expects to work.

• Linux
• macOS
• Windows 10 or Windows 11, with WSL 2.

Prerequisites

Java is the only prerequisite to run Deephaven's production application with Groovy. The Python version of this guide covers running a Python server.

Get the artifacts

The Deephaven artifacts are attached to each Deephaven release. Only the server artifact, in tar format, is required to run the production application.

Set your preferred version in an environment variable. The shell commands in this guide set and use DH_VERSION. Replace LATEST_VERSION_HERE with the version number of the most recent release, without the leading v:

You can download release artifacts from your browser of choice or via the command line:

Unpack the server

Unpack the server artifact from your file explorer or with the command line:

Run the server

The server contains a bin/ directory with a start script. To start the server, run the start script:

The command sets START_OPTS, an environment variable that the start script passes to the JVM as extra arguments.

The server starts a Python console by default, so -Ddeephaven.console.type=groovy selects Groovy instead. Every command in this guide that starts the server includes it. See Configure the production application for other options.

The server prints its logs to the console, and the web UI is available at http://localhost:10000.

To stop the server, press Ctrl+C.

Authentication

By default, Deephaven uses pre-shared key authentication. If you don't set a key, the server generates a random key each time it starts and prints it to the console, like this:

Open the URL in the second log line, which includes the key, to sign in automatically.

To set your own pre-shared key, add -Dauthentication.psk=YOUR_PASSWORD_HERE to START_OPTS. The following command sets that key:

The following command uses anonymous authentication:

Multiple servers

To run several servers on one machine, give each server its own name and port:

• DEEPHAVEN_APPLICATION names the server and gives it its own configuration, cache, and data directories. See Configure the production application.
• -Dhttp.port, set in START_OPTS, gives each server its own port.

The following commands start two servers:

Next steps

Related documentation

• Configure the production application
• Pre-shared key authentication
• Version matrix
• WSL 2 clock drift