Alteryx Server Knowledge Base

Definitive answers from Server experts.

Maps tiles do not render in Server UI



Map tiles fail to render when the Server UI and Controller are on the same host and Service level TLS is enabled. 


Environment Details

  • Alteryx Server FIPS
    • 2022.2
  • Map Input Interface Tool
  • Server UI and Controller on the same server



This occurs because Server UI attempts to communicate with the Service using localhost over port 443 and the TLS certificate is not valid for localhost.



Solution A

  1. Edit %programdata%\Alteryx\RuntimeSettings.xml
  2. Under the <Controller> section locate, highlight, and copy the <ServerSecretEncrypted> tag including the current value
  3. Find the <Worker> section
  4. Paste the copied <ServerSecretEncrypted>
  5. Create a new tag as follows: <UseLocalServer>False</UseLocalServer>
  6. Create another new tag <ServerName></ServerName>
  7. Inside the <ServerName> add the canonical fully qualified domain name (FQDN) for your server e.g. https://host.domain.tld
  8. Save the updated RuntimeSettings.xml file
  9. Restart the AlteryxService
    <ServerName>https://host.domain.tld </ServerName>
Note: The TLS certificate installed on your host must specify this exact FQDN (host.domain.tld in the example above) in either the Subject (CN) or Subject Alternate Name (SAN) fields

Solution B

  1. Add localhost as a Subject Alternative Name on the TLS certificate

Solution C

  1. Host the Controller and Server UI on separate machines