Docs Menu

Configure Geospatial Tile Server and Attribution Message

On this page

You can configure the following properties of your geospatial charts:

Tile Server
Tile servers provide geospatial charts with map images. By default, Charts connects to a cloud-hosted tile server.
Attribution Message
The attribution message is the text that is displayed at the bottom of geospatial charts. Typically, this message contains licensing information regarding the tile server.

You can specify your own tile server and attribution message for geospatial charts in your Charts Docker Compose file.

To configure your tile server and attribution message:


Open the Docker Compose file you downloaded as part of the Charts Installation Procedure.


Add CHARTS_TILE_SERVER and CHARTS_TILE_ATTRIBUTION as variables to the environment section of your Compose file.


The following table describes the tile server URL components:

Data Type
X tile number
Y tile number
Zoom level

The following CHARTS_TILE_SERVER variable uses map tiles from Stamen Maps:{z}/{x}/{y}.jpg

The variable follows standard Markdown syntax.


Use the following Markdown to specify a custom attribution message for Stamen map tiles:

Map tiles by [Stamen Design](,
under [CC BY 3.0](
Data by [OpenStreetMap](, under [ODbL]

If MongoDB Charts is already running, remove the Charts Docker stack using the following command:

docker stack rm mongodb-charts

Before redeploying, you need to ensure that the Charts containers are fully shut down. You can confirm this by running the docker ps command several times, until it shows no running Charts containers.

Once all Charts containers have shut down, relaunch the stack using the following command:

docker stack deploy -c charts-docker-swarm-19.12.2.yml mongodb-charts

If you are using a different version of Charts, replace 19.12.2 with the version number of your release.

Give Feedback
© 2021 MongoDB, Inc.


  • Careers
  • Legal Notices
  • Privacy Notices
  • Security Information
  • Trust Center
© 2021 MongoDB, Inc.