Skip to main content
Environment Presets allow you to customize infrequently changed configurations for your Notebook Runtime. These currently include:
  • Wherobots version
  • Spark configuration
  • Dependencies
You manage Environment Presets in Organization Settings > Environments. The Environment button in the New Notebook Runtime dialog only selects a preset. It links to Manage environments in Organization Settings.
The New Notebook Runtime dialog with the Environment button

The New Notebook Runtime dialog

To create a custom preset, do the following:
  1. Go to Organization Settings > Environments.
  2. Click Create Environment.
  3. Enter a Name, choose a Version, and add any Spark configuration and dependencies.
  4. Click Save.
The name must be unique in your Organization.

Edit, clone, or delete a preset

Open the actions menu of a preset’s row in the Environments table, then choose one of the following:
  • Edit: Change the preset’s settings. You can’t change the name of an existing preset.
  • Clone: Open a new preset with the source preset’s settings and an empty name. Use Clone to save a preset under a new name.
  • Delete: Remove the preset.
The built-in Default preset only offers Clone.

Change Wherobots Version

You can customize the Wherobots version for your Notebook Runtime. The default Wherobots version is the latest version.

Change Spark Configuration

Add any custom spark configurations you want before starting the Notebook Runtime.

Adding Dependencies

We support both FILE and PYPI as sources for dependencies inside Notebook Runtimes. Below you will find the directions for adding dependencies from each source.

Adding Dependencies from a File

Wherobots Cloud allows you to add dependencies from Wherobots Managed Storage or an S3 storage integration.
Supported file types Only Python Wheel (.whl), JAR (.jar), ZIP (.zip), and JSON (.json) files are supported.
Please refer to Managed Storage folders and permissions to upload the files in the correct directory.
Click “Browse” and select the file in the file picker. The selected file must have a valid file extension (.whl, .jar, .zip, or .json).
The file picker lists Managed Storage and your S3 storage integrations. My Files is not listed, and private /data/customer-… folders cannot be selected.
JSON files can be used to place a configuration file at a predetermined file-system location on all nodes of the compute cluster (/opt/wherobots/<file name>.json).

Use wheels built for arm64

Notebook Runtimes and Job Runs run on arm64 processors, which Python calls aarch64. The end of a wheel’s file name says which processors it installs on: For a package with compiled code, download the arm64 wheel and upload that file:
Set --python-version to the Python version of the runtime. If you build the wheel yourself, build it on Linux arm64. To check the processor and Python version of a runtime, run the following in a notebook cell or a job:
The output looks like aarch64 3.12.3.

PYPI Source

You can add dependencies from the PYPI source by entering the package name, optionally with a version, such as package==1.0.0.
The Source Type menu of a dependency, with PYPI and FILE

Select source type

When the Notebook Runtime starts, it will fetch and install listed packages from PYPI.

Environment Override Presets

Configurations present in Environment Override Presets are subject to change. Configurations may be added or removed as the product evolves.
Environment Overrides allow you to customize the most commonly updated values for your Notebook Runtime. These currently include:
  • Driver disk size
  • Executor disk size
  • Spark configuration
Environment Overrides are available only to Organizations with access to disk size options. At launch, an override’s disk sizes replace the runtime’s default disk sizes, and its Spark configuration takes precedence over the Environment Preset’s. To select an Environment Override, do the following:
  1. Open the New Notebook Runtime dialog.
  2. Click Environment.
  3. Choose an override from the Environment Override dropdown.
To create a custom Environment Override, do the following:
  1. Go to Organization Settings > Environment Overrides.
  2. Click Create Environment Override.
  3. Enter a Name, a Driver Disk Size (GB), an Executor Disk Size (GB), and any Spark configuration. Leave a disk size empty to use the default size for the runtime.
  4. Click Save.
Environment Overrides support the same Edit, Clone, and Delete actions as Environment Presets.

Change Disk Size

You can customize the default disk size for your Notebook Runtime. The default disk size for driver and executor nodes is based on the runtime size and is listed below:

Spark Configuration

Refer to the Spark configuration section for more information.