---
title: "Install and run MapTiler Server on Raspberry Pi | Guides | Self hosting | Map server"
description: "How to install MapTiler Server on a Raspberry Pi minicomputer."
---

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

# Install and run MapTiler Server on Raspberry Pi

[MapTiler Server](https://www.maptiler.com/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:

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

For help with these tasks, please refer to the [official Raspberry Pi documentation](https://www.raspberrypi.com/documentation/computers/getting-started.html).

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](https://docs.maptiler.com/guides/self-hosting/map-server/maptiler-server-technical-specification).

## Install MapTiler Server

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

## Run MapTiler Server

1.  When installed, start the application from the terminal:
    
    ```bash
    maptiler-server
    ```
    
2.  The command automatically generates an **admin password**. Copy it from the terminal output.
3.  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/`.
4.  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:

1.  Find your Pi’s IP address by running `hostname -I` in the terminal.
2.  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:

1.  Run the service configuration script:
    
    ```bash
    sudo maptiler-server-servicify
    ```
    
2.  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](https://docs.maptiler.com/guides/on-prem/server/getting-started/).

## 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](https://dev.to/bolollo/maptiler-server-on-raspberry-pi-a-geeks-guide-to-self-hosted-maps-19d4) on DEV.to.