---
title: "Use MapTiler vector tiles on local (offline) QGIS instance | Guides | Self hosting | Map server"
description: "Download and view MapTiler vector tiles offline using 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.

# Use MapTiler vector tiles on local (offline) QGIS instance

The article describes a way, how to download data, setup local instance of MapTiler Server, and use the data e.g. QGIS for later offline usage.

In the case, you are offline, you still can pre-download [MapTiler data](https://data.maptiler.com/) and display them  
e.g. using [QGIS](https://qgis.org) or a web browser. For this, you need 3 things: 

-   The data at this [site](https://data.maptiler.com)
-   MapTiler Server, download from [here](https://www.maptiler.com/server/download/)
-   If you need a desktop GIS, use [QGIS](https://www.qgis.org/en/site/) and install the [MapTiler QGIS Plugin](https://plugins.qgis.org/plugins/qgis-maptiler-plugin/) 

With the QGIS Plugin, you already can display all our maps. But this solution describes, how to see your data offline.

## Step 0: Register at MapTiler.com service

Most of the data and configuration files are available, some of them for free, but you have to register yourself in our service account. Go to e.g. [https://cloud.maptiler.com](https://cloud.maptiler.com) and _Sign in_

## Step 1: Download the data

Go to [https://data.maptiler.com](https://data.maptiler.com) and download the requested dataset. NOTE: Most of the datasets are free, but if you go into the bigger level of detail, they are paid. Once you have your _maptiler-…\*.mbtiles_ file secured, proceed to step 2.

## Step 2: Download basic styles as a ZIP file

To be able to see the data, you need to download and unzip basic styles. We are providing the styles available at [https://data.maptiler.com/server/](https://data.maptiler.com/server/) _NOTE: you have to be registered into our services_

Once the data and styles are downloaded, start the MapTiler Server.

## Step 3: Download and Start the MapTiler Server

After you download the MapTiler server for your computer (use the free download link from [MapTiler Server Page](https://www.maptiler.com/server/download/). Once installed, start the server.

You may use the command line for this. In Linux systems, start the Terminal application (usually available if you press Ctrl+Alt+t). On Windows, you have to run the _cmd.exe_ command from the menu. 

maptiler-server –adminPassword YOUR\_PASSWORD –workDir C:\\data\\maptiler-data\\

The –_adminPassword_ parameter will set administrator password and _\--workDir_ parameter will set target directory, where necessary data and configuration will be stored. On Windows, you may use something like _c:\\path\\to\\data\\dir_, on Linux, it will look like _/home/user/data/dir._

## Step 4: Upload data and styles to MapTiler Server

Open the Web browser and go to the URL `http://localhost:3650/admin`. After login Drag & Drop the downloaded styles (as a ZIP file) to the administrative interface.

![screen9.png](./screen9_3e78074be6.webp)

You will get a basic set of map styles and data tiles samples.  
Go to _Tiles_ (`http://localhost:3650/admin/tiles`) and drag & drop the downloaded MBtiles file.

![screen10.png](./screen10_f94370bd0b.png)

You will get a new dataset along with the two samples.![screen1.png](./screen1_a6100c3138.png)

## Step 5: Change data ID

The map Styles and data Tiles are bound together. The Styles (_Basic, Topo, Streets, …_) are referring to the data Tiles by unique ID. We just need to switch it, to make the server use the correct input data.

1.  Go to the _MapTiler data (Zurich sample)_
2.  Change the ID from _maptiler-osm_ to _maptiler-osm-zurrich_ (see picture lower)
3.  Go to uploaded custom Tileset and change the ID to _maptiler-osm_![screen11.png](./screen11_20d38d9fb6.webp)

Now check the maps and they all should use the newly uploaded dataset.

## Step 6: Start QGIS and use the MapTiler plugin to read the data from the local MapTiler Server Instance

In QGIS, right-click on the MapTiler data source and pick _Add a new map …_ selection option.

![screen5.png](./screen5_f205ce804e.png)

In the dialogue, set the name for your new map and insert the _style.json_ URL.

![screen6.png](./screen6_d251cccace.png)

After saving, you should see a new layer in the data catalog and you should add it to QGIS.

![screen7.png](./screen7_49e00e12fc.webp)

## Conclusion

As a result of the process, you should now see the following:

-   You have your own copy of the data on your computer
-   You have running MapTiler Server on your computer, you can now share it with your colleagues who are in your network.
-   Your QGIS instance is displaying local data from the local MapTiler server instance, you can go offline, and everything will work - as long as MapTiler Server is running.