Map Hosting

Standard web server

On a standard hosting (such as an ordinary company web server) you can very simply host your maps. Just load the directory with tiles to your web hosting and the layer is automatically available.

Once uploaded, the produced maps can be opened in any viewer supporting OGC WMTS standard.

For hosting of MBTiles, you can use MapTiler Server, that can be used with any standard hosting that supports PHP. Upload the created maps and get dozens of popular web viewers with interactivity, including Google Maps API, Leaflet, OpenLayers, WebGL Earth and MapBox JS. There is a standalone how-to describing the whole process of hosting with MapTiler Server.

Cloud Hosting - CloudPush

The CloudPush command can be used for upload to Amazon S3, Google Cloud Storage or Microsoft Azure Blob hosting. Examples are shown on the S3. If you need to use Google Cloud Storage or Microsoft Azure Blob, just change the “s3” to “gs” or “az”, respectively. Full how-to with visual examples is available as a how-to article.

Cloud Push instance is initialized with the first uploaded map via this command line utility. It automatically creates an empty index.json, in index.html and sets WebSite configuration for this bucket. To get the required credentials, see the section Access credentials below.

Upload tiles from an MBTiles file to S3

  maptiler-cloudpush --access_key ACCESS_KEY --secret_key SECRET_KEY s3://bucket_name add filename.mbtiles

List all maps in the cloudpush tile storage

  maptiler-cloudpush --access_key ACCESS_KEY --secret_key SECRET_KEY s3://bucket_name list

Delete a map

  maptiler-cloudpush --access_key ACCESS_KEY --secret_key SECRET_KEY s3://bucket_name delete filename

Delete whole cloudpush storage

  maptiler-cloudpush --access_key ACCESS_KEY --secret_key SECRET_KEY s3://bucket_name destroy

Access credentials

The Amazon access and the secure key are available via IAM service administration interface. The credentials for the Google Cloud Storage are under “Enable interoperable access” in the menu of the service. The Azure Blob Storage requires the Storage account name as Access Key and the Key from the Microsoft Azure Portal - Storage Accounts - Access keys.

Instead of providing the access credentials in every command these can be set as system environment variables.

Example on Windows OS:

  REM for Amazon S3
  REM or for Google Cloud Storage
  REM or for Microsoft Azure Storage

Example on Linux / macOS:

  # for Amazon S3
  # or for Google Cloud Storage
  # or for Microsoft Azure Storage

and call the utility without these arguments:

  maptiler-cloudpush s3://bucket_name list
  maptiler-cloudpush s3://bucket_name add filename.mbtiles
  maptiler-cloudpush gs://bucket_name list
  maptiler-cloudpush az://bucket_name list

Advanced options

It is possible to use further options such as:


automatically creates bucket, if not existing


not handling metadata in CloudPush instance index.json


same as –no-index-json

-basename [path]

sets custom basename (default: basename of MBTiles file)


uploaded objects are private (default: public)


Enable Azure Storage Emulator API

List of available parameters can be displayed by running ./maptiler-cloudpush without any parameter

Example for using custom basename:

  maptiler-cloudpush --basename myfile s3://bucket_name add filename.mbtiles

uploads tiles with URL format: myfile/z/x/y.ext. Custom basename contains directory separators (slash), for example:

  maptiler-cloudpush --basename year/month/myfile s3://bucket_name add filename.mbtiles

result will have URL in format: year/month/myfile/z/x/y.ext.

Region-specific hosting can be set up via environment variable AWS_BUCKET_REGION=[value] or with parameter -R [value].

Example for EU (Ireland) region:

  maptiler-cloudpush -R eu-west-1 s3://bucket_name add filename.mbtiles

The list of S3 regions is provided by the utility with --more-help argument or visible at

To enable uploading tiles into Azure Storage Emulator, you need to pass the parameter --emulator for each command:

Example for emulator, does not require credentials:

  maptiler-cloudpush --emulator az://bucket_name add filename.mbtiles

The Azure Storage uses the API of the version 2015-02-21.