Upgrade ArcGIS Notebook Server (Windows containers)

ArcGIS Notebook Server on Windows containers is supported on Windows Server 2022 and Windows Server 2025.

Note:

If you have a previous installation of ArcGIS Notebook Server on Windows Server 2019, you must upgrade the operating system prior to upgrading to ArcGIS Notebook Server on Windows containers. Alternatively, you can perform a fresh installation of ArcGIS Notebook Server on Windows Server 2022 or Windows Server 2025 and configure it as the Notebook Server server for your ArcGIS Enterprise deployment.

Note:

If your notebook server is currently in read-only mode, turn the mode off before beginning the upgrade process.

Back up the deployment

Before you upgrade, it's recommended that you make backups of the deployment.

See Back up and restore ArcGIS Notebook Server for more information.

Upgrade ArcGIS Notebook Server installed on a supported Windows OS

To upgrade ArcGIS Notebook Server on Windows Server 2022 or Windows Server 2025, complete the following steps:

1. Upgrade your ArcGIS Enterprise deployment.
2. Uninstall ArcGIS Notebook Server samples data.
3. Upgrade ArcGIS Notebook Server using the setup program or the command line.
4. Unregister the previous instance of ArcGIS Web Adaptor from your site.
5. Uninstall ArcGIS Web Adaptor.
6. Install a new instance of ArcGIS Web Adaptor 11.5 and configure it with ArcGIS Notebook Server.

   Note:

   Ensure the same web adaptor instance name is maintained.

7. Upgrade your container engine.

   If using Mirantis Container Runtime, upgrade to version 25.0.8 or later.

   If using Docker Engine from binaries, upgrade to version 28.0.1 or later.

8. Install the most recent ArcGIS Notebook Server Windows container images.
9. Each notebook author must update the runtime of their existing notebook items and web tools to the most recent ArcGIS Notebook Server runtime.

   See the Change a notebook runtime section for more information.

   If a notebook is published as a web tool, you must overwrite that web tool after updating the notebook runtime.

   Note:

   If any notebooks were running custom runtimes, you must rebuild and reregister the custom runtimes on the Windows Notebook Server and update the runtime settings for the associated notebook items.

   Update the memory and CPU usage settings configured in your runtimes.

10. Optionally, remove the previous version of the ArcGIS Notebook Server runtimes image to free up disk space.

    Caution:

    Ensure that all existing notebooks have been updated to use the most recent version of the ArcGIS Notebook Server runtime image.

    1. List the images.

       docker images -a

    2. Note the IMAGE ID corresponding to the previous version of the ArcGIS Notebook Server runtime image.
    3. Remove the image.

       docker image rm <IMAGE ID>

Upgrade ArcGIS Notebook Server on Windows Server 2022 and migrate from Linux containers to Windows containers

To upgrade ArcGIS Notebook Server on Windows Server 2022 from a previous installation and migrate from Linux containers to Windows containers, complete the following steps:

1. Upgrade your ArcGIS Enterprise deployment.
2. Uninstall ArcGIS Notebook Server sample data.
3. Upgrade ArcGIS Notebook Server using the setup program or the command line.
4. Unregister the previous instance of ArcGIS Web Adaptor from your site.
5. Uninstall ArcGIS Web Adaptor.
6. Install a new instance of ArcGIS Web Adaptor 11.5 and configure it with ArcGIS Notebook Server.

   Note:

   Ensure the same web adaptor instance name is maintained.

7. Once your notebook server has restarted and the administrator site directory is accessible, sign in as an administrative user.
8. Click Notebooks > Runtimes.
9. Run Restore Factory Runtimes.

   This will update the Esri notebook runtimes to use the Windows container-based notebook runtime images.

10. Uninstall Docker Desktop.
11. Install Mirantis Container Runtime or Docker Engine from binaries.
12. Install the most recent ArcGIS Notebook Server Windows container images.

    Note:

    For a multimachine site, repeat steps 3 and 10 through 12 for each machine in your site.

13. Each notebook author must update the runtime of their existing notebook items and web tools to the most recent ArcGIS Notebook Server runtime.

    See the Change a notebook runtime section for more information.

    If a notebook is published as a web tool, you must overwrite that web tool after updating the notebook runtime.

    Note:

    If any notebooks were using custom runtimes, you must rebuild and reregister the custom runtimes on the Windows notebook server and update the runtime settings for the associated notebook items.

14. Update the memory and CPU usage settings configured in your runtimes.

Upgrade from ArcGIS Notebook Server on Windows Server 2019 with Linux containers to ArcGIS Notebook Server on Windows Server 2022 or Windows Server 2025 with Windows containers

To upgrade to ArcGIS Enterprise on Windows Server 2022 or Windows Server 2025 with ArcGIS Notebook Server on Windows containers from a previous installation on Windows Server 2019 with Linux containers, complete the following steps:

1. Remove your ArcGIS Notebook Server from ArcGIS Enterprise with the following substeps:
   1. Sign in to the ArcGIS Portal Directory administrator location as an administrator for your organization.

      Note:

      The URL is https://webadaptorhost.domain.com/arcgis/portaladmin, where arcgis is the name of the web adaptor registered with your portal.

   2. Click Federation > Servers.
   3. Choose the notebook server you want to unfederate.
   4. Click Unfederate.
2. Upgrade your ArcGIS Enterprise deployment.
3. On the new notebook server machine, set up prerequisite software.
4. Install ArcGIS Notebook Server 11.5 on Windows Server containers.
5. Configure ArcGIS Notebook Server after installation.
6. Create a site.
7. Install and configure ArcGIS Web Adaptor.
8. For a multimachine site, repeat steps 4 and 5 on each machine and join additional machines to the site.
9. Configure ArcGIS Notebook Server with the portal.
10. Ensure that each notebook author updates the runtime of their existing notebook items and web tools to the most recent ArcGIS Notebook Server runtime.

    See the Change a notebook runtime section for more information.

    If a notebook is published as a web tool, you must overwrite that web tool after updating the notebook runtime.

    Note:

    If any notebooks were using custom runtimes, you must rebuild and reregister the custom runtimes on the Windows notebook server and update the runtime settings for the associated notebook items.

11. Update the memory and CPU usage settings configured in your runtimes.