How to display self-hosted maps from MapTiler Server in QGIS

This article demonstrates how to display self-hosted maps from MapTiler Server in QGIS. It contains the setup process and adds a few useful tips on performance improvements of the integration.

Important notice

Support for vector tiles was introduced to QGIS in version 3.14 (Pi). You need QGIS 3.14 or newer to fully take advantage of vector tiles. To add maps into QGIS you need to know its StyleJSON URL or have an access to the administration of the MapTiler Server. Your MapTiler Server should be running on an open port (3650 by default).

MapTiler Server Administration

You should be able to see your maps in the MapTiler Server administration page. Read the article How to add data to MapTiler Server and this article for further information.

Select the map you want to add to QGIS a click on the Detail button.

On the detail page, find the Use vector style section and link to StyleJSON.

Open QGIS with installed MapTiler plugin. For further information about the plugin read this article.
Right-click on MapTiler plugin → Add a new map… Insert the name of the map and paste copied StyleJSON from MapTiler Server.

Your self-hosted map will be added to the list of maps under the MapTiler Plugin. Double-click on the map and your map will be added to the QGIS map canvas.

Conclusion

With a combination of MapTiler Server and MapTiler Plugin in QGIS, you can easily add a self-hosted map to your QGIS project.

Useful links

How to add data to MapTiler Server
How map styles work in MapTiler Server