Install and run MapTiler Server on Raspberry Pi

MapTiler Server supports the ARM64 architecture, allowing you to host maps on Raspberry Pi minicomputers. This lightweight, portable setup is ideal for self-hosting maps on the go, including offline environments.

Before you start

If your Raspberry Pi device is new, make sure to:

Install Raspberry Pi OS (64-bit) or another Debian-based ARM64 distribution.
Set up wi-fi connection.

For help with these tasks, please refer to the official Raspberry Pi documentation.

As a storage for your maps, we recommend a microSD card with at least 32 GB of space. You can also use the card for transferring the Server installation package to your Pi.

Technical requirements

Only 64-bit devices are compatible (Raspberry Pi 3 and later).
A minimum of 2 GB RAM is required. MapTiler Server may run on a device with less memory, but will be only usable for basic testing. See the full technical specification.

Install MapTiler Server

Go to Server download page.
Get the Debian (ARM64) installation package. There are two Debian package versions available. Be careful to select the one for ARM64 architecture!
Open the command line terminal and switch to your download folder:
```
 cd /home/<username>/Downloads
```
Run the installation using the filename with your version number:
```
 sudo dpkg -i maptiler-server-<x.x.x>.deb
```

Run MapTiler Server

When installed, start the application from the terminal:
```
 maptiler-server
```
The command automatically generates an admin password. Copy it from the terminal output.
Open a web browser and go to the MapTiler Server interface at http://localhost:3650/admin/. If you have changed the default port, the address will be http://localhost:<custom-port>/admin/.
Log in using the generated admin password.

To change the administration password or other settings, run maptiler-server --help to list the options.

Remote (headless) access

The steps to access the MapTiler Server admin interface assume that you have a monitor, mouse, and keyboard connected to the Raspberry Pi and are working on the device directly. However, if you’re connecting via SSH from another computer on the same network, you need to use Raspberry Pi’s IP address instead of localhost:

Find your Pi’s IP address by running hostname -I in the terminal.
On your primary computer, open a browser and go to http://<ip-address>:<port>/admin/.

Set up autostart

Optionally, configure MapTiler Server to start automatically when the Raspberry Pi boots:

Run the service configuration script:
```
 sudo maptiler-server-servicify
```
Follow the prompts to set up your working directory (use absolute path), port, and custom admin password.

The script creates a systemd service and starts it immediately.

What’s next

MapTiler Server is now running and you can proceed to 👉 deploy sample maps.

Community resources

For a fun step-by-step walkthrough that includes building a demo map application, see MapTiler Server on Raspberry Pi – A Geeks’ Guide to Self-Hosted Maps on DEV.to.