Self-host maps server

    The following sections provide steps for setting up and using the self-host maps server with OpenSearch Dashboards.

    You can access the image via the official OpenSearch Docker Hub repository.

    Open your terminal and run the following command:

    docker pull opensearch/opensearch-maps-server

    Set up the server

    You must set up the map tiles before running the server. You have two setup options: Use the OpenSearch-provided maps service tiles set, or generate the raster tiles set.

    docker volume create tiles-data

    Download the tiles set from the OpenSearch maps service. Two planet tiles sets are available based on the desired zoom level:

    The planet tiles set for zoom level 10 (2 GB compressed/6.8 GB uncompressed) is approximately 10 times larger than the set for zoom level 8 (225 MB compressed/519 MB uncompressed).

    To generate the raster tiles set, use the and then use the tiles set absolute path to create a volume to start the server.

    Use the following command to start the server using the Docker volume tiles-data. The following command is an example using host URL “localhost” and port “8080”:

    To access the tiles set, open the URLs in a browser on the host or use the curl command .

    Confirm the server is running by opening each of the following links in a browser on your host or with a curl command (for example, curl http://localhost:8080/manifest.json).

    • Map manifest URL: http://localhost:8080/manifest.json
    • Map tiles demo URL:

    Use the self-host maps server with OpenSearch Dashboards

    You can use the self-host maps server with OpenSearch Dashboards by either adding the parameter to opensearch_dashboards.yml or configuring the default WMS properties in OpenSearch Dashboards.

    Configure the manifest URL in opensearch_dashboards.yml:

    map.opensearchManifestServiceUrl: "http://localhost:8080/manifest.json"

    1. On the OpenSearch Dashboards console, select Stack Management > Advanced Settings.
    2. Locate visualization:tileMap:WMSdefaults under Default WMS properties.
    3. Change to "enabled": true and add the URL for the valid map server.