This setting applies to On-Premise/Private Cloud deployments only. On Cloud instances, map sourcing is managed by Teramind.
Introduction
Teramind’s Geolocation reports and widget data sources show where monitored activity happens, which helps security teams spot impossible-travel logins, detect data access from unexpected locations, and add geographic context to productivity analytics, insider-risk investigations and more. The map background behind that data is drawn from map tiles: small images the browser stitches together as you pan and zoom.
Starting with on-prem server update TMU 949, a Geolocation map tiles section under Settings > About lets you choose where those tiles come from. You can use a world map built into the installation, host a high-detail map on your own server, load tiles from Teramind’s hosted tile service, or turn maps off entirely. Nothing is fetched from the internet unless you explicitly select a source that requires it.
Why This Matters
Air-gapped and restricted networks: geolocation maps render in deployments with no internet access, using the bundled offline map.
Privacy and compliance: no outbound contact to third-party map services unless an administrator explicitly enables it.
Administrative control and auditability: map sourcing is a recorded configuration choice you can review, restrict, or disable.
Detail versus footprint: choose the trade-off between map resolution and server storage, from a lightweight built-in world map up to full street-level detail.
Before You Begin
You need administrator access to the Teramind server and dashboard.
The Geolocation map tiles section appears only when geolocation is enabled on your instance. If you do not see it, contact Teramind Support.
Map Tile Source Options
The Geolocation map tiles section contains two controls: MAP TILES, which selects the source, and DOWNLOAD ARCHIVE, which fetches a high-detail map archive onto the server. MAP TILES offers four options, and each states its network behavior directly beneath the dropdown, so the privacy implication of the choice is visible at the moment you make it.
Option | What it does | Network access |
Off | No maps are shown. Geolocation widgets render without a map background. | None |
Bundled world overview | Uses the world overview map built into the installation (zoom level 6, continent and country detail). Works immediately, including in fully air-gapped environments. | None |
Downloaded archive | Serves tiles from a high-detail archive downloaded onto your own server via DOWNLOAD ARCHIVE. Detail up to street level, hosted entirely on-premise. | One-time download from |
Teramind tile server | The user’s browser loads tiles directly from Teramind’s hosted tile service ( | Browser-side only at the endpoint |
Dashboard Based Method
Use this method for any map source change when you can reach the Teramind web interface, which covers most deployments. Use Option 1 if the source you want needs no download, and Option 2 if you need city- or street-level detail hosted on your own server.
Option 1: Select a Map Tile Source
Use this option when the source you want needs no download.
1. Click the Gear 
icon near the user’s name in the top-right corner of the dashboard and select Settings.
2. Select the About tab and scroll to the Geolocation map tiles section.
3. From the MAP TILES dropdown list, select the source you want. The text below the dropdown confirms what that option does and what network access it needs. Here are the options you can choose from:
Bundled World Overview: This is the default option. The bundled map covers the whole world at zoom level 6, which shows country and continent outlines only. If your dashboards need city- or street-level detail, use a downloaded archive or the Teramind tile server instead.
Teramind Tile Server: Your users’ browsers, not the server, must be able to reach tiles.teramind.co. If your network filters outbound traffic, allow that host or choose one of the offline options.
Off: Geolocation widgets still render, without map imagery behind them.
Downloaded Archive: Available only after an archive has been downloaded onto the server. See Option 2.
4. Click the Save button.
Option 2: Host a High-Detail Map on Your Own Server
Use this when your dashboards need city- or street-level detail but the server must not depend on an outside service to draw maps. You download a map archive onto the server once, then point MAP TILES at it. The download is the only step that reaches the internet, and nothing is fetched again until you request another download.
1. Click the Gear icon near the user’s name in the top-right corner of the dashboard and select Settings.
2. Select the About tab and scroll to the Geolocation map tiles section.
3. Select a map from the DOWNLOAD ARCHIVE dropdown list. Each option shows the level of details it covers. You can also see how much free space you have on your maps volume under the dropdown list.
4. Click the Download button. A confirmation dialog states which host will be contacted, how much will be downloaded, and that nothing is contacted afterwards until you request another download:
5. Click CONFIRM. Progress is shown on the page, for example: Queued, Downloading, Verifying. and the button becomes Cancel. The transfer is self-verifying and resumable, so an interrupted download picks up where it left off rather than starting again.
6. When the download completes, you will see the archive’s name under the MAP TILES list.
7. Select Downloaded archive from the MAP TILES dropdown list.
8. Click the Save button.
Note: The server keeps one archive at a time. Each new download replaces the previous one, and Downloaded archive option always serves the most recent. Since each detail level includes everything in the smaller ones, download the highest level you need rather than several levels in turn.
CLI Method
These options are alternative ways to carry out scripted installations and for servers with no browser access.
Option 1: Interactive Download (Default Detail Level)
tmprem.pl -func maps_download
Downloads the default map archive and prompts for confirmation before starting.
Option 2: Unattended Download of a Specific Detail Level
tmprem.pl -func maps_download --maps_max_zoom=10 -y
Downloads the "City districts and major roads" archive (zoom 10, roughly 3.8 GB). --maps_max_zoom=N selects the detail level, the same as the DOWNLOAD ARCHIVE dropdown list in the dashboard, where a higher zoom means more detail and a larger file. -y skips the interactive confirmation, for use in scripts.
Option 3: Full Street-Level Archive
tmprem.pl -func maps_download --maps_max_zoom=15 -y
Downloads the largest archive (zoom 15, roughly 138 GB). Confirm the server has enough free disk space before starting.
Option 4: Fully Offline Install From File
tmprem.pl -func maps_download --source=FILE
Installs an archive that was downloaded elsewhere and copied to the server, for example via USB, for machines with no internet access at all.
Troubleshooting
Section Not Visible: The instance either has no approved BI node or does not have geolocation enabled. Check both, then reload the page.
Blank Maps With Downloaded Archive: Check the line above DOWNLOAD ARCHIVE. It reads No archive downloaded. until one is installed, and Local archive: build, zoom and size afterwards. If none is installed, run the download first.
Blank Maps With Teramind Tile Server: The users’ browsers, not the server, must reach
tiles.teramind.co. Check browser-side network filtering and proxy rules.Detail Stops at Country Outlines: You are on the bundled map (zoom 6). Switch to a downloaded archive or the tile server for city- and street-level detail.
Download Fails or Stalls: Retry from the page. The transfer resumes rather than restarting. If disk space is the cause, choose a smaller detail level.