Domino Standard Environments

Each Domino installation comes with a standard Environment known as the Domino Standard Environment (DSE). Periodically, Domino publishes a new set of standard Environments with updated libraries and packages. These Environments include some common data science packages and libraries pre-configured for use in Domino.

Domino also makes a Domino Minimal Environment (DME) available that includes only the packages required to work in Domino. These are a good option if you want to build a Domino-compatible Environment from scratch. This helps speed Environment build times and execution start times.

Domino Cluster Environments work like a Domino Standard Environments, but have additional libraries to support specific types of clusters. They contain the same workspace tools and general packages as the DSE to support general data science workflows. You can use these Environments with any Domino execution like a Workspace or Job, but they are best used in a distributed compute cluster alongside a Domino Cluster Environment. These are smaller and simpler Environments and are only suitable for use in the worker nodes of the cluster. DSEs cannot be used for worker nodes in a cluster.

Warning

Do not use or archive the 5.2.0 Snowflake Model Export Environment (Domino internal). This Environment is for Domino’s use only to export a Domino model to Snowflake.

Domino Compute Environments

Domino Environments (abstractions on top of Docker images). Users can create Environments, use those provided by Domino, or edit existing ones.

Domino Standard Environment (DSE): Domino Standard Environments are Environments that we make available with standard sets of libraries and packages.

The Domino Standard Environment can handle common data science workflows out of the box. It includes the most common Python and R packages.

Note	To take advantage of features in Domino 5.0 and up, use the 5.0 Domino Standard Environment.

See Environments for information about how to add packages to the DSE. The DSE comes with a GPU version that includes CUDA support and common packages for taking advantage of GPUs. WARNING: Domino recommend using an Environment with explicit GPU support when using GPU hardware tiers.

See the compute Environment catalog to access Domino Standard Environment images.

Domino Minimal Environment (DME): The DME has fewer packages and is lighter weight than the Domino Standard Environment (DSE).

The Domino Minimal Environment includes Jupyter and JupyterLab workspace support, but does not include several packages that are included in the DSE. Domino recommends using the DME if you will be doing several custom installations on top of a base Environment image, because its smaller size speeds build times and avoids conflicting dependencies. See Environments for information about how to add packages to the DME.

See the compute Environment catalog to access Domino Minimal Environment images.

Domino Cluster Environments

The following Environments are designed to be used with compute cluster Environments. You can use these Environments with any Domino execution like a Workspace or Job, but they are best used in a distributed compute cluster alongside a Domino Compute Cluster Environment.

Compute Cluster Environments work like the Domino Standard Environments, but they have additional libraries to support a specific cluster type. They contain the same workspace tools and general packages as the DSE to support general data science workflows.

A cluster won’t work correctly if the worker nodes are not using the appropriate Domino Cluster Environment for cluster workers and compatible Domino Compute Environment for Job or Workspace.

Domino Spark Environment

The Domino Spark Environment is built specifically for workspaces that control a Spark cluster. It includes Scala and Spark on top of the typical DSE functionality. This Environment is best used alongside a Spark cluster Environment. To ensure compatibility between the Spark compute Environment and Spark cluster Environment, the Spark and Python versions must match across Environment images.

See the compute Environment catalog to access Domino Minimal Environment images.

See Create a base Spark cluster Environment.

Domino Ray Environment

The Domino Ray Environment is built specifically for workspaces that control a Ray cluster. It includes Ray on top of the typical DSE functionality. This Environment is best used alongside a Ray cluster Environment. To ensure compatibility between the Ray compute Environment and Ray cluster Environment, the Ray and Python versions must match across Environment images.

See the compute Environment catalog to access Domino Minimal Environment images.

See Create a base Ray cluster Environment.

Domino Dask Environment

The Domino Dask Environment is built specifically for workspaces that control a Dask cluster. It includes Dask on top of the typical DSE functionality. This Environment is best used alongside a Dask cluster Environment. To ensure compatibility between the Dask compute Environment and Dask cluster Environment, the Dask and Python versions must match across Environment images.

See the compute Environment catalog to access Domino Minimal Environment images.

GPU Environment flavors

The Domino Standard Environment also includes a GPU version with support for CUDA and common GPU specific libraries like Torch and Tensorflow. These GPU-enabled Environment images are larger, so Domino recommends that you use them only if you are using a GPU-enabled hardware tier.

FUSE Environment flavors

The DSE Environment also has a version that includes FileSystem in Userspace (FUSE) binaries to enable Goofys and SSHFS support. You can add these commands to your Environment Dockerfile to enable FUSE functionality:

USER root

# Goofys
ADD https://github.com/kahing/goofys/releases/download/v0.24.0/goofys  /usr/bin/
RUN chmod a+x /usr/bin/goofys

# SSHFS
RUN apt-get update && apt-get install -y sshfs &&
    sed -i "s/^#user_allow_other/user_allow_other/" /etc/fuse.conf

USER ubuntu

5.0 Environment changes

Stability and security are improved in the Domino Environments for 5.0. The following are the key changes in the 5.0 Domino Environment images:

Fixed R Kernel in Jupyter
Added Domino-specific packages to Environments, like domino-data-capture, and dominodatalab-data
Add Spark Cluster and Spark Compute Environments by default to new deploys to support the Cohort Analysis feature
Fixed Jupyter notebook subdomain support
Added more Ray packages to the Ray Compute Environment

4.6 Environment changes

There were several changes to Domino Environments in 4.6 as we shifted from the DAD to the DSE. These changes were the result of an improvement of our internal Environment building practices, which now enable us to build Environments faster and therefore support a larger catalog of unique images. In addition, our newer images are slimmer, leading to faster build and startup times and fewer security vulnerabilities.

The following are the key changes in the 4.6 Domino Environment images:

Removed hundreds of Python and R packages from the image.
Removed Scala and Scala Kernel.
Removed FUSE (Goofys and SSHFS) binaries in default image.

These are still available in FUSE image

Removed VSCode in JupyterLab extension in favor of distinct VSCode IDE option
Python 3.8.8 → 3.8.10
miniconda py38_4.8.3 → py38_4.9.2
R 4.0.5 → 4.1.0
openjdk 1.8.0_292 → 11.0.11
nodejs v14.17.0 → 16.4.1
jupyter-notebook 6.3.0 → 6.4.0
jupyter-lab 3.0.15 → 3.0.16
rstudio 1.4.1106 → 1.4.1717
code-server 3.7.3 → 3.10.2
Purged some unused apt-get dependencies

Moved workspace start scripts from /var/opt/workspaces to /opt/domino/workspaces. New images symlink old directory, so change is backwards compatible.
Added Snowflake data connector
Removed Kerberos libs
Removed R Jupyter Kernel
Added image metadata including workspace properties and language versions

These changes improved image security and reduced image size by 3.5 GB.

FAQ

How can I tell which image I’m currently using?: The URI for the image will be listed on your compute Environment’s overview page. If your Environment is built on top of another Environment, you may need to click through to the parent Environment before seeing the underlying docker image.
I have a third-party Docker image, can I use that in Domino?: When you create an Environment with a custom image, use the Automatically make compatible with Domino checkbox. See Create a Domino Environment for details.
How can I learn about new versions of the DSE and make feature requests?: See the Compute Environment Catalog for the list of environments. To make feature requests, submit a request to Domino support.