topic Re: Notebook Server - Unable to validate runtime in ArcGIS Enterprise Questions

Notebook Server - Unable to validate runtime

tigerwoulds — Sat, 23 Mar 2024 21:36:42 GMT

Running ArcGIS Enterprise 11.1 on Windows, Notebook Server is using Linux containers and a standard license. I have ran through all the pre-reqs - docker desktop w/ linux contains and hyper-v, downloaded linux images from MyEsri, and installed using the postinstallutiltiy.bat which succeeded.

Running docker image ls on my notebook server returns the following:

When attempting to open any notebook I get this error. When I try to validate the standard runtime through notebook/admin, runtimeexists is false.

{ "machines": [{ "machine": "[REDACTED]", "notebookRuntimes": [ { "notebookRuntimeName": "ArcGIS Notebook Python 3 Standard", "runtimeExists": "false", "notebookRuntimeVersion": "8.0" }, { "notebookRuntimeName": "ArcGIS Notebook Python 3 Advanced", "runtimeExists": "false", "notebookRuntimeVersion": "8.0" } ] }], "status": "success" }

Any ideas or other steps I need to take to have notebook server validate the standard runtime?

Re: Notebook Server - Unable to validate runtime

TimoT — Sun, 24 Mar 2024 10:28:16 GMT

Navigate to Notebook Administrator Directory > notebooks > runtimes and confirm the image ID matches the one in your error.

You mentioned downloading the Linux containers and images. I understand that Docker is native to Linux, but I still downloaded the the docker container images from the Windows section of My Esri. They probably aren't different in any way though since they have the same checksum.

Good luck.

Timo

Re: Notebook Server - Unable to validate runtime

tigerwoulds — Mon, 25 Mar 2024 19:31:24 GMT

Hey Tim, thanks for the response. I did confirm Image ID matches and used the same container download from your screenshot (those are infact linux container images). I ended up resolving the issue by going to Notebook Server Admin > System > Properties and setting the useWindowsContainers property to false. I then went to Notebook > Runtimes and restored the factory runtimes. We're running Windows Server 2022 and these additional steps are required.

This is mentioned in the doc but oddly enough, only on the welcome page: https://enterprise.arcgis.com/en/notebook/11.1/install/windows/welcome-to-the-arcgis-notebook-server-install-guide.htm

Re: Notebook Server - Unable to validate runtime

IngJuanMaSuarez — Wed, 27 Mar 2024 19:08:56 GMT

In ArcGIS Enterprise version 11.2, the same thing happened to me. The error was resolved by following these instructions. Thank you very much.

Re: Notebook Server - Unable to validate runtime

LennardLux — Tue, 20 Jan 2026 13:57:33 GMT

I encountered the same issue, but with ArcGIS Enterprise 11.5 under Linux Ubuntu 24.04 (single-machine deployment).

These are the notebook images in the docker registry (docker image ls):

The registered Notebook Runtimes under <FQDN>/notebook/admin/notebooks/runtimes have different image IDs compared to the images in the docker registry. Thus, they are flagged with "runtimeExists" : "false" when validating the runtimes (notebook/admin/notebooks/runtimes/register):

[{ "machine": "[REDACTED]", "notebookRuntimes": [ { "notebookRuntimeName": "ArcGIS Notebook Python 3 Standard", "runtimeExists": "false", "notebookRuntimeVersion": "12.0" }, { "notebookRuntimeName": "ArcGIS Notebook Python 3 Advanced", "runtimeExists": "false", "notebookRuntimeVersion": "12.0" } ] }]

I downloaded the Images specifically for Linux. Restoring the factory runtimes does not work, it only changes the Image IDs of the already registered runtimes, and are not equal to the ones found in the local Docker registry still.

Registering the Notebook Runtimes from the docker registry manually works, but that is not what the Postinstallation Utility script intends.

Has anyone had the same issue and found a solution? So far I can only speculate what is going wrong. Maybe it is the Docker Configuration or the configuration of the Reverse Proxy? If someone has an idea I'd be happy and thankful to exchange some information!

Re: Notebook Server - Unable to validate runtime

LennardLux — Tue, 20 Jan 2026 16:48:37 GMT

Update: The issue was not setting "containerd-snapshotter" explicitly to "false" in /etc/docker/daemon.json.

Since the release of Docker Engine 29.X containerd-snapshotter is enabled by default, thus breaking the registration of runtime images in Notebook Server for Enterprise 11.5. Setting containerd-snapshotter to false is only mentioned in the latest documentation of ArcGIS Notebook Server for Linux (Version 12.0).

Re: Notebook Server - Unable to validate runtime

MortenMartinsen — Wed, 18 Mar 2026 08:20:31 GMT

Hej @LennardLux

Did you run the postinstall after the Docker settings where changed?

Re: Notebook Server - Unable to validate runtime

LennardLux — Wed, 18 Mar 2026 08:24:07 GMT

Hi Morten, it's been a while, but iirc i re-installed the entire system/server to make sure this was the only issue.

Re: Notebook Server - Unable to validate runtime

MortenMartinsen — Wed, 18 Mar 2026 09:50:09 GMT

@LennardLux it worked! Thanks