---
title: Configure your Deephaven Instance
sidebar_label: Configure your Instance
---

This last section covers configuration details needed to take your Deephaven instance beyond the defaults.

## Authentication

Keeping your real-time data secure is one of Deephaven's top priorities. As such, the default installation of Deephaven is equipped with [pre-shared key (PSK) authentication](../../how-to-guides/authentication/auth-psk.md). By default, this key is randomly generated and available in the Docker logs (if using Docker) on startup:

![Docker logs showing the PSK](../../assets/how-to/docker-logs.png)

It is advised that you change the password from a randomly generated string to your own password for enhanced security. For the [Docker one-liner installation](../../tutorials/quickstart.md#1-install-and-launch-deephaven), you can set your password with the `-Dauthentication.psk` flag:

```bash skip-test
docker run --rm --name deephaven -p 10000:10000 -v data:/data  --env START_OPTS=-Dauthentication.psk=YOUR_PASSWORD_HERE ghcr.io/deephaven/server-slim:latest
```

To learn more about PSK authentication, see the [user guide](../../how-to-guides/authentication/auth-psk.md) on the topic.

In addition to PSK authentication, Deephaven supports the following types of authentication:

- [Anonymous](../../how-to-guides/authentication/auth-anon.md)
- [Keycloak](../../how-to-guides/authentication/auth-keycloak.md)
- [mTLS](../../how-to-guides/authentication/auth-mtls.md)
- [Username / Password](../../how-to-guides/authentication/auth-uname-pw.md)

## Deployments

Deephaven provides [multiple Docker images](../../tutorials/docker-install.md#image-versions). Each of these images, called deployments, comes pre-installed with different Python packages. You also have the option of including [Deephaven's example data](https://github.com/deephaven/examples) in any of these images.
Many of these images integrate with popular Python libraries. For example, the [`server-all-ai`](https://github.com/deephaven/deephaven-core/pkgs/container/server-all-ai) image comes pre-installed with [PyTorch](https://pytorch.org), [Tensorflow](https://www.tensorflow.org), [scikit-learn](https://scikit-learn.org/stable/), and [nltk](https://www.nltk.org). You can use this image with this Docker command:

```bash skip-test
docker run --rm --name deephaven -p 10000:10000 ghcr.io/deephaven/server-all-ai:latest
```

To learn more about deployments, check out the guide for [installing Deephaven with Docker](../../tutorials/docker-install.md).

## Installing Java packages

Even with a standard deployment, you may need to install new Java packages at some point. To install packages, the package must be added to a custom Docker image. This allows imports to persist across all instances of Deephaven that are started with the custom image. See the [user guide on installing Java packages](../../how-to-guides/install-and-use-java-packages.md) for more information.

## RAM

Large datasets require significant memory — often much more than the 4G that Deephaven allocates by default. Fortunately, it's easy to give Deephaven more memory.

If you're using Docker-installed Deephaven, Docker itself imposes memory constraints on processes it runs - you can raise this ceiling in [Docker Desktop](https://docs.docker.com/desktop/settings-and-maintenance/settings/#resources) by going to `Settings > Resources` and raising the memory parameter. Then, you can specify the memory allocated to Deephaven with the `-Xmx` flag. Here's the command to pull and run the latest version of the Deephaven server with 16G of RAM:

```bash skip-test
docker run --rm --name deephaven -p 10000:10000 --env START_OPTS=-Xmx16g ghcr.io/deephaven/server-slim:latest
```

The [memory guide](../../how-to-guides/heap-size.md) explains more about allocating memory in Deephaven.

## Keep your instance up-to-date

The data world is ever-evolving, and so is Deephaven. It's easy to keep your instance up-to-date, taking advantage of the latest features and bug fixes.

If you're running Deephaven with Docker, simply use `docker pull` to pull the latest version of the image from the repository:

```bash
docker pull ghcr.io/deephaven/server-slim:latest
```

Users with custom Docker installations should check out [this guide](../../how-to-guides/configuration/updating-deephaven.md#update-deephaven) for information on updating custom instances.