---
title: "How to display self-hosted maps from MapTiler Server in QGIS | Guides | Self hosting | Map server"
description: "Connect and display MapTiler Server self-hosted maps in QGIS."
---

> For AI agents: a documentation index is available at [/llms.txt](https://docs.maptiler.com/llms.txt). Markdown versions of all pages are available by appending .md to any URL.

# 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.

_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 on the MapTiler Server administration page. Read the article [How to add data to MapTiler Server](https://docs.maptiler.com/guides/self-hosting/map-server/how-to-add-and-host-data-in-maptiler-server#:~:text=Upload%20the%20data%20to%20the%20server,-Uploading%20content%20to&text=MapTiler%20Server%20supports%20direct%20upload,or%20use%20the%20upload%20button.&text=MapTiler%20Data%20starter%20pack%20%2D%20zip,data%20%2D%20extracted%20directly%20into%20%24workingDirectory) and [this article](https://docs.maptiler.com/guides/self-hosting/map-server/how-to-work-with-map-styles-in-maptiler-server) to get even more information.

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

![](./4410789253777_1fa7c313e5.webp)

On the detail page, find the _Use vector style_ section and link to StyleJSON.

![](./4410781191825_bdc4f08128.png)

Open QGIS with installed MapTiler plugin. For further information about the plugin read [this article](https://docs.maptiler.com/guides/self-hosting/map-server/how-to-work-with-map-styles-in-maptiler-server).  
Right-click on MapTiler plugin → _Add a new map…_ Insert the name of the map and paste copied StyleJSON from MapTiler Server.

![](./4410767084561_9a3660f648.png)

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.

![](./4410781191953_f686ef5838.webp)

## How to connect raster tiles from MapTiler Server to QGIS

The process of connecting raster tiles to QGIS via MapTiler QGIS plugin is simple. Follow these steps:

1.  **Install** MapTiler QGIS plugin according to [this guide](https://docs.maptiler.com/guides/maps-apis/maps-platform/how-to-print-and-show-vector-tiles-in-qgis-via-maptiler-plugin).
2.  **Set** **up** the **authentication** for the QGIS plugin according to [this guide](https://docs.maptiler.com/guides/maps-apis/maps-platform/how-to-set-up-authentication-for-maptiler-qgis-plugin).
3.  **Install** MapTiler Server for [Win](https://docs.maptiler.com/guides/on-prem/server/installation/windows/), [Linux](https://docs.maptiler.com/guides/on-prem/server/installation/linux/), or [Docker](https://docs.maptiler.com/guides/on-prem/server/installation/docker/).
4.  In MapTiler Server, go to Maps.
5.  **Click** **to** **select** a map you want to connect to QGIS.
6.  **Scroll** down **to** **Map** **service** (raster tiles).
7.  **Copy** **link** “tiles.json” to the map.
8.  In QGIS, **Right-click** the MapTiler plugin in the left vertical menu.
9.  Select **Add a new map**
10.  **Select the “from URL” tab**
11.  **Copy the link from MapTiler Server here.**
12.  **Double-click** **the** **map** you have just selected to **add** **it** **to** your layer **view**.
13.  **Continue** **working** on your edits.

## How to connect XYZ tiles from MapTiler Server to QGIS

The process of connecting XYZ tiles to QGIS via MapTiler QGIS plugin is simple. Follow these steps:

1.  In MapTiler Server, **go to Maps**.
2.  **Click** **to** **select** a map you want to connect to QGIS.
3.  **Scroll** down **to** **XYZ tiles** (raster tiles).
4.  **Copy** **link** to the map `https://localhost:3650/api/maps/your_style_name_/{z}/{x}/{y}.png`.
5.  In QGIS, **Right-click** the XYZ tiles in the left vertical menu.
6.  Select **New connection.**
7.  **Put in** the **name** and the **URL link** to the map (from step 4).
8.  **Double-click** **the** **map** you have just selected to **add** **it** **to** your layer **view**.
9.  **Continue** **working** on your edits.

## How to connect WMTS from MapTiler Server to QGIS

The process of connecting WMTS to QGIS via MapTiler QGIS plugin is simple. Follow these steps:

1.  In MapTiler Server, **go to Maps**.
2.  **Click** **to** **select** a map you want to connect to QGIS.
3.  **Scroll** down **to** **WMTS.**
4.  **Copy** **link** `https://localhost:3650/api/maps/your_map_style_name/WMTSCapabilities.xml`.
5.  In QGIS, **Right-click** the WMS/WMTS in the left vertical menu.
6.  Select **New connection.**
7.  **Put in** the **name** and the **URL link** to the map (from step 4).
8.  **Double-click** **the** **map** you have just selected to **add** **it** **to** your layer **view**.
9.  **Continue** **working** on your edits.

## 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](https://docs.maptiler.com/guides/self-hosting/map-server/how-to-add-and-host-data-in-maptiler-server)  
[How map styles work in MapTiler Server](https://docs.maptiler.com/guides/self-hosting/map-server/how-to-work-with-map-styles-in-maptiler-server)