Docker is a popular containerization technology. Docker containers bundle software in a complete file system with everything that is needed to run it. Docker containers run the same regardless of your operating system. To learn more about docker, refer to the official documentation. The ArcGIS API for Python is shipped as a Docker image which you can download and power up whenever you want to use the API. These images when spun up into containers, run in an isolated environment without making any changes to your local file system.
Follow the steps below to get Docker on your computer and run the API:
-
Download docker and install it on your computer.
-
Once installed, run the following command in terminal to pull Docker image
docker pull ghcr.io/esri/arcgis-python-api-notebook -
Then spin up the image into a container using the following command in terminal. Replace the
<localport>with an available port number, for instance8889.docker run -it -p <localport>:8888 ghcr.io/esri/arcgis-python-api-notebook -
When the container starts, it will provide a 127.0.0.1 URL (with a one time token) to open your local Notebook instance. Copy the URL and paste it in your browser's address bar to use the notebooks.