ArcGIS Urban on ArcGIS Enterprise 11.4 is supported on Windows and Linux operating systems.
Install ArcGIS Urban on Microsoft Windows
The following section explains how to install Urban on a Windows machine.
Note:
Run all the commands listed in this section using the Run as administrator option in PowerShell.
Prerequisites
Before installing Urban, ensure that the following prerequisites are met:
- Verify your environment meets the minimum system requirements.
- Prior to installing ArcGIS Urban, you must install ArcGIS Enterprise as a base deployment.
- You must use a Windows Active Directory account to install ArcGIS Enterprise and ArcGIS Urban. The installation will not succeed if you use a Local User account.
- You must install ArcGIS Urban on the machine where Portal for ArcGIS is installed.
- You can access and use a system account user with administrative-level access.
- Ensure that the Web Styles component is installed with ArcGIS Enterprise. See Portal for ArcGIS Web Styles installation for details.
- To enable searching for addresses in your urban model, you must add a geocode service to your organization and share the locator item with everyone. See Configure the organization to geocode addresses to learn more.
Note:
ArcGIS Urban is currently not supported in the following Portal for ArcGIS setups:
- Portal for ArcGIS installations that use public key infrastructure (PKI)-based client certificate authentication.
- Portal for ArcGIS installations that use Lightweight Directory Access Protocol (LDAP) to secure portal access.
- Portal for ArcGIS installations that use Integrated Windows Authentication (IWA) to secure portal access.
- Disconnected deployments of ArcGIS Enterprise.
Enable containerization on Windows
To enable containerization on Windows, complete the following steps:
- Open PowerShell or the Server Management UI and enable the Container feature.
- Restart your machine.
Install Docker
To install Docker on Windows, complete the following steps:
Note:
Use the Docker command line. Do not use Docker Desktop.
- Download the Docker runtime and CLI binaries from the Docker website. It is recommended that you download the latest available patch for Docker version 27.
The downloaded zip file containing Docker runtime and CLI binaries is available on your disk.
- Create the following directory: C:\Program Files\docker.
- Move and extract the
downloaded zip file to the location created in the previous step.
The following files are available: dockerd.exe, docker.exe, and docker-proxy.exe.
- Include the Docker installation location to the systemwide path environment variables.
- Restart your machine.
The new environment variable is picked up.
- Open PowerShell and go to the Docker installation location.
- Register the Docker service by running the following command: dockerd.exe --register-service.
- Start the Dockerservice by running the following command: Start-Service docker.
- Ensure that the service is running by running the following command: Get-Service docker.
The returned service status is Running.
- Check whether the setup was successful by running the following command: docker run --rm
hello-world.
The resulting message indicates that the Docker installation appears to be working correctly.
Configure access to Docker
To configure access to Docker for the Portal for ArcGIS system account, complete the following steps:
- Create a local user group on the Windows machine named docker-users.
- Add the account that is running the Portal for ArcGIS service to the docker-users group.
- Check whether the following JSON file exists: C:\ProgramData\docker\config\daemon.json
If the location and the file do not exist, create it.
- Add the following line to the deamon.json file: { "group" : "docker-users" }
Install Urban
To install Urban, do the following:
Run the ArcGIS Urban installer. No additional configuration is required during installation.
Note:
The Urban Docker container uses TCP port 9443. The port cannot be changed.
Install ArcGIS Urban on Linux
The following section explains how to install Urban on a Linux machine.
Prerequisites
Before installing Urban on ArcGIS Enterprise 11.4, ensure that the following prerequisites are met:
- Verify your environment meets the minimum system requirements.
- Prior to installing ArcGIS Urban, you must install ArcGIS Enterprise as a base deployment.
- You must install ArcGIS Urban on the machine where Portal for ArcGIS is installed.
- Ensure that the Web Styles component is installed with ArcGIS Enterprise. See Portal for ArcGIS Web Styles installation for details.
- To enable searching for addresses in your urban model, you must add a geocode service to your organization and share the locator item with everyone. See Configure the organization to geocode addresses to learn more.
Install Docker
To install Docker on Linux, complete the following steps:
- Ensure that Docker is available on your Linux distribution. If Docker is not available, continue with the substeps:
- Install Podman by following the instructions on the Podman website.
- Add the following alias: alias docker="podman".
- Use your package manager to install the Docker package.
- Ensure that Docker is started as a service by running the following command: systemctl status docker.
- If Docker is not enabled, enable it by running the following commands: sudo systemctl enable docker and sudo systemctl start docker.
Configure access to Docker
To configure access to Docker for the Portal for ArcGIS system account, do the following:
Add the account that is running the Portal for ArcGIS service to the Docker user group.
Install Urban
To install Urban, do the following:
Run the ArcGIS Urban installer. No additional configuration is required during installation.
Note:
The Urban Docker container uses TCP port 9443. The port cannot be changed.