Pre-requisites for automatic custom image compatibility

The following requirements must be present in custom images for use with the automatic compatibility feature:

  • bash 4.2+

  • shadow-utils, including

    • groupadd

    • useradd

  • glibc 2.23+, including:

    • libc.so.6

    • libpthread.so.0

    • libcrypt.so.1

    • libutil.so.1

    • libdl.so.2

    • libm.so.6

These requirements are typically satisfied by images based on the following off-the-shelf distributions of Linux:

  • CentOS Linux 7 (or later)

  • Debian GNU/Linux 10 (or later)

  • Red Hat Enterprise Linux 8.2 (or later)

  • Ubuntu 16.04.2 LTS (or later)

Note

Alpine Linux distribution images are not officially supported. Alpine images might work if the previous requirements are met, but this has not been validated.

The following table shows the requirements that must be present in the image for each of the default Domino Workspace Tools, as well as the requirements for Domino Jobs. If a tool isn’t working, check to see if its requirements are present in the image. You can modify the base image or add Dockerfile instructions to the Domino Environment if there are missing requirements.

Workspace ToolRequires PythonRequires Jupyter

Domino Jobs

No

No

VS Code

Yes

No

JupyterLab (kernels present)

Yes

Yes

JupyterLab (terminal only)

No

No

Note
  • Jobs can be used without Python or Jupyter. However, if you want to run a Python script in a job, then you need Python in the custom image.

  • JupyterLab can be launched even if Python and Jupyter are not installed, but only a basic terminal will be available and the JupyterLab "Launcher" will be empty. To use a terminal, open JupyterLab and then click File > New > Terminal.