About Domino
Domino Data LabKnowledge BaseData Science BlogTraining

Create a Domino Environment

This guide shows you three ways to create a new Domino Environment, whether you want to create a core Domino environment, base it on an existing environment, or start from a custom setup.

Tour the New Environment window

Create a new Environment

  1. Name: The name you give your environment.

  2. Description (Optional): Use this to record details about your environment.

  3. Base Environment / Image: There are two options for a base environment/image:

    1. Start from an existing Environment: Base your new environment on a Domino environment.

    2. Start from a custom base image: Input a URI to build a custom environment.

  4. Supported Clusters: Lists the currently supported types of clusters.

  5. Visibility: Choose a visibility level: Private, Available to an Organization, or Globally Accessible (admin only).

  6. Customize before building: Use this to add custom features to your environment.

  7. Create Environment: Validates and creates your new environment.

Create environment based on Domino Core Environment

Domino comes with the Domino Core Environment installed, but you can create a new Domino Environment using the available environment images.

  1. Go to Govern > Environments and click + Create Environment.

  2. Fill in the following fields:

    1. Name: Name your environment according to the naming convention of your organization.

    2. Description (Optional): Enter a meaningful description of the environment. For example, you could add details like the OS, Python version, and whether the environment uses Jupyter, JupyterLab, VS Code, etc.

  3. Choose Start from an existing Environment for your Base Environment / Image.

    1. The global default for your environment is pre-selected.

    2. Scroll until you can select the Domino Core Environment.

  4. Choose an option for any Supported Clusters.

  5. Decide on your environment’s Visibility level: Private, Available to an Organization, or Globally Accessible (admin only).

  6. Click Create Environment. The Revisions tab for the environment opens.

To customize the environment to enable tools, run scripts, or manage environment variables, click Customize before Building and use the Edit Environment Definition guide.

You can also click Edit Definition to customize the environment later.

Create environment based on existing environment

You can create a new Domino Environment by duplicating existing Environments.

  1. Go to Govern > Environments.

  2. Choose the environment you want to copy and click the three dots on the right.

  3. Choose Duplicate Environment from the menu.

  4. Rename it clicking the edit icon and then entering when done.

  5. You can edit other fields quickly to customize them:

    1. Edit Description: Click Update when you are done with the description.

    2. Edit Visibility: Click Update Visibility when finished.

Use the Edit Environment Definition article for guidance to enable tools, run scripts, or manage environment variables.

Create environment based on custom images

Choose your custom Docker or container image before creating a new environment and copy the URI.

  1. Go to Govern > Environments and click +Create Environment.

  2. Fill in the following fields:

    1. Name: Name your environment according to the naming convention of your org

    2. Description (Optional): Enter a meaningful description of the environment. For example, you could add details like the OS, Python version, and whether the environment uses Jupyter, Jupyterlab, VScode, etc.

  3. Choose Start from a custom base image for your Base Environment / Image.

    1. FROM: Paste the custom Docker or container image URI here.

    2. Optional: Review the information about the Automatically make compatible field.

  4. Choose an option for any Supported Clusters.

  5. Decide on your environment’s Visibility level: Private, Available to an Organization, or Globally Accessible (admin only).

  6. Click Create Environment. The Revisions tab for the environment opens.

To customize the environment to enable tools, run scripts, or manage environment variables, click Customize before Building and use the Edit Environment Definition guide.

You can also click Edit Definition to customize the environment later.

Archive an environment

You can archive environments as long as they are not the default environment for a project. Archiving an environment does not affect reproducibility; executions based on it will still run.

  1. Go to Govern > Environments.

  2. Choose an environment from the list.

  3. There are two ways to archive an environment quickly:

    1. You can click the 3 dots within the list and choose Archive Environment.

    2. Choose Archive Environment from the menu. You can also archive from any tab within the Environment details.

Next Steps