nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

Is there a Trick to Installing ArcGIS Urban on Enterprise Portal 11.5

JohnRitsko1

I'm trying to install ArcGIS Urban on my Enterprise Portal 11.5 Windows 2022 Server machine. I've done every single step ESRI states and everything seems to be on track with installing docker, creating the group, etc. etc. However, when I get done with all the steps ESRI states to just install ArcGIS-Urban so I simply run the exe as Administrator and then afterwards, no joy! I'm getting the http.500: Failed to route request error shown here https://doc.arcgis.com/en/urban/11.5/get-started/get-started-enterprise-faq.htm#anchor2 . However, this does "NOTHING" to help resolve why I'm seeing it. Question: Is there something prior to running this install (ArcGIS_URBAN 11.5) that I'm supposed to do with docker that ESRI fails to mention? I'm using docker version Docker version 27.5.1, build 9f9e405.

Find more posts tagged with

Accepted answers

All comments

DominikAllemann

Hi @JohnRitsko1 ,

I'm sorry to hear that you are experiencing issues with installing Urban on Enterprise Portal 11.5.

Based on your post, it appears that you have already thoroughly followed the instructions outlined in the "Install ArcGIS Urban on Windows" user guide. If you are working with a multi-machine deployment, please ensure that ArcGIS Urban & Docker are installed on the same machine where Portal for ArcGIS is installed.

To further narrow down the issue, can you please check the following:

Is Docker installed correctly? To check for that, please run the command below in a console (run as administrator):

docker run --rm hello-world

If yes to the above, is the ArcGIS Urban Docker container available? Check that by running the following command in a console, and check if an image called "arcgis-urban" gets listed:

docker image ls --all

If yes to the above, please verify that the arcgis-urban container is running. To do that, please run the following command in a console:

docker container ls --all

This command will list all Docker containers available on your machine, including their status (running, stopped, or exited)

Please feel free to DM me screenshots of the outputs from the commands above.

I'm sure we'll get Urban running on your Enterprise 11.5 portal soon.

Thanks,

Dominik

JohnRitsko1

Dominik,

Thank you so much for the reply. Yes, I have followed ESRI's install to the letter, yes multi machine environment with Urban going on our ArcGIS Portal machine. Had a call yesterday with ESRI as well to try and figure this out but our time ran out after 45 minutes so we couldn't continue so I figure worth a shot posting in community to see if others have run into this before.

Before I rant on what I've done and answer your questions I did have a question about docker. ESRI documentation states "Download the Docker runtime and CLI binaries from the Docker website". There is no CLI (Command LIne Interface) link only the link to docker to get the (docker, dockerd) executables in the zip file from the link provided by ESRI. If there is some assumption that I know how to find this CLI libraries file I think I missed how and where to get this installed. I only downloaded the docker-27.5.1.zip file, which is missing the docker-proxy.exe file that ESRI says should be in there. I tried version 28.0.0 but that didn't work either. Anyway, if there is another file for this CLI then I'm missing that and perhaps that's my issue.

Is Docker installed correctly? To check for that, please run the command below in a console (run as administrator): YES, and I get the following:
- Hello from Docker!
  This message shows that your installation appears to be working correctly. etc. etc.
If yes to the above, is the ArcGIS Urban Docker container available? Check that by running the following command in a console, and check if an image called "arcgis-urban" gets listed:
- No arcgis-urban is listed. In the documentation "NOTHING" states to how to fix this part if it's not listed, other than I'm guessing to run through all the steps again, which doesn't work. Ports were configured as well per instructions as well. Am I supposed to create a container for it?
- REPOSITORY TAG IMAGE ID CREATED SIZE
  hello-world latest c16a0562ffc0 12 days ago 297MB
  hello-world nanoserver c16a0562ffc0 12 days ago 297MB
If yes to the above, please verify that the arcgis-urban container is running. To do that, please run the following command in a console:
- CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
  - Nothing further is shown.

I'd rather post in here in case others ever run into this issue as well. After installing docker and setting up the local group and adding the c:\Program Files\docker to the PATCH in environmental variables I'm not sure what else could be going on so I very much appreciate any input.

For some context I also installed the Web Styles for Windows 11.5 prior to Urban.

ESRI states to enable the container feature but doesn't provide the commands so this is what I ran:

Install-WindowsFeature -Name Containers

Success Restart Needed Exit Code Feature Result
------- -------------- --------- --------------
True No NoChangeNeeded {}

Added the "C:\Program Files\docker" to the Path in Environmental Variables.

Created the docker-users AS A LOCAL GROUP.

Added the User that is running ArcGIS Portal to the group.

Docker Version

PS C:\program files\docker> docker --version
Docker version 27.5.1, build 9f9e405

Then I simply run the executable for Urban as Administrator and then get the error shown above. I just feel like I'm missing one simple step somewhere in this process. Thank you all for the input.

DominikAllemann

Hi @JohnRitsko1

Thank you very much for sharing all those details.

Re your question about CLI binaries & the missing "docker-proxy.exe"
I will double-check with one of our developers to verify if there's something missing in the downloaded zips accessible from the link in the documentation, or if the documentation would need to be adapted.

Re your comment about the FAQ section
Thanks for your input. I agree that it would be beneficial if the documentation states what to do if the "arcgis-urban" image/the "arcgis-urban" container is not listed. We will review how to improve that part of the documentation to add more value to our customers.

Re getting Urban on your server running
From afar, it's difficult to determine exactly what didn't go as it should have. To avoid re-installing the entire system, I suggest trying to load the "arcgis-urban" image manually into Docker.

You can complete the following steps to achieve that:

Sign in to the server using the account that also runs the Portal service.
Locate the file called "urban.tar" (this is the Docker image for Urban; it might be suffixed with the Windows Server version e.g. "urban2022.tar"). On Windows servers, it's usually located at "C:\Program Files\ArcGIS\Portal\framework\etc\urban"
Open PowerShell as administrator and navigate to the folder of "urban.tar".
Load the image using the command below:

docker load -i urban.tar

Loading the image can take a while on Windows Servers (usually anything between 15mins and 30mins)

Verify if the image was loaded successfully by running the command below:

docker image ls

Once the image is available, it will be picked up by the "Portal service" which will create a container out of it. This might take another couple of minutes. Consider restarting the portal service manually to speed things up a bit.

Double-check for the creation of the "arcigs-urban" container by running the following command:

docker container ls --all

The "arcgis-urban" container should now be listed and you can access ArcGIS Urban from the Enterprise Portal.

Please don't hesitate to reach out if you have any further questions.
Thanks,
Dominik

JohnRitsko1

Argh, looks like found my issue wasn't using a domain account from AD to install Portal and as such I would venture a guess this is causing most if not all my issues.

JohnRitsko1

Well that hasn't solved my problem. arcgis-urban shows up but still no joy. I had to run the "RUN" command to create the container for the arcgis-urban image. S

PS C:\Program Files\ArcGIS\Portal\framework\etc\urban> docker image ls
REPOSITORY TAG IMAGE ID CREATED SIZE
hello-world latest c16a0562ffc0 13 days ago 297MB
arcgis-urban latest 0ae93cb10049 6 months ago 832MB

PS C:\Program Files\ArcGIS\Portal\framework\etc\urban> docker container ls --all
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
419df04c51d4 arcgis-urban "node dist/app/src/s…" 3 minutes ago Exited (1) 2 minutes ago objective_heisenberg

PS C:\Program Files\ArcGIS\Portal\framework\etc\urban> docker run arcgis-urban
preventAutoInstrumentationFor => {}
info: 🔓 Using insecure HTTP for hosting...
error: Fatal exception when starting HTTP server: Error: Unable to start Urban: URBAN_API_PORTAL_URL is not defined.

DominikAllemann

Hi @JohnRitsko1

Could you locate the file called "urban.env" on your server, open it with a text editor, and share its content via DM (as it contains information that you may not want to share with the entire world-wide-web)?

Thanks,
Dominik

GJameson

Dominik -

Did you connect with the developers regarding the docker-proxy.exe?

27.1.1 is the last release that I found that has it included in the downloads.

Thanks,

Greg

DominikAllemann

Hi @GJameson ,

Thanks for following up regarding the docker-proxy.exe file.

It is not required for Urban. The Urban product documentation will be updated accordingly in the second half of November 2025.

Thanks,

Dominik

DominikAllemann

Update:

@JohnRitsko1 got to the root of the issue.
There was an issue with the firewall rules for the port that Urban uses.

whadi

Hi @DominikAllemann,

I installed ArcGIS Urban in Enterprise 12.0 using Docker version 28.5.2, but it looks like this:

i found that the container was running:

PS C:\Windows\system32> docker --version
Docker version 28.5.2, build ecc6942
PS C:\Windows\system32> docker ps
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
4f9b2735079f arcgis-urban:latest "node dist/app/src/s…" 3 days ago Up About a minute 0.0.0.0:9443->5000/tcp arcgis-urban

Do you have experience like that?

DominikAllemann

Hi @whadi ,

I'm sorry to hear that you are experiencing issues after installing Urban in Enterprise 12.0.

1. On what server OS did you install Enterprise?

2. When you get the "Oh Snap" screen in Urban, can you open the browser's dev tools and there check the console and the network tab for any errors?

3. Could you locate the file called "urban.env" on your server, open it with a text editor, and share its content via DM (as it contains information that you may not want to share with the entire world-wide-web)?

Thanks,

Dominik

TapanDhar1

Hi @DominikAllemann I am also facing same issue.
I have installed and configured ArcGIS URBAN with Enterprise 11.5. however, the URBAN is not loading.

The docker image is created.

docker images error errorUrban env

DominikAllemann

Hi @TapanDhar1 ,

Sorry to hear that you are having issues with the installation.

The content of the urban.env file looks correct.
Did you have to create the container manually?

As a last resort, I'd recommend the following steps. If this doesn't resolve the issue for you, please contact Esri support:

Remove the exited arcgis-urban container.
Recreate the container manually and explicitly point to the urban.env file and the urban certificate directory.
To do that, complete the following steps:
- Find the absolute path to urban.env file
- Find the absolute path to the urban certificate directory
- Run the command below and replace the two path placeholders (for urban.env file & for urban certificate directory):
```
docker run -d --name arcgis-urban --env-file "<absolute_path_to_urban.env>" -p 9443:5000 -v "<absolute_path_to_urban_certificate_dir>:/urban-api/certificates" arcgis-urban:latest
```

Let us know if this resolves the issue.

Thanks,
Dominik

TapanDhar1

HI @DominikAllemann
Thank you for the response, I will perform the same and update you.

LorenzMeyer1

The same issue after installing ArcGIS Urban on Windows Server 2022 with ArcGIS 12.1.

Docker image was not pulled, container not loaded. Did all the installation steps required with

enable "container" feature in Server Manager
User docker CLI
Set system environment path for docker
created daemon.json with groups
created user group and added the domain account that runs the portal for arcgis service.
installed urban…

Join the Conversation

Signed in members can post, follow updates, and more. New here? Register a free account.

Quick Links

Community Help
Find useful guides, FAQs, and documents to help you navigate and make the most of Esri Community.