Install and run MapTiler Server on Linux

This page describes the installation of MapTiler Server on Linux-based systems. On Raspberry Pi, the same instructions apply but there’s a few specifics to keep in mind—see MapTiler Server on Raspberry Pi.

Install MapTiler Server

  1. Get the installation package from the Server download page. We provide DEB packages for Debian-based Linux distributions (Ubuntu, Debian, Mint, …), RPM packages for RedHat-based distributions (Red Hat, Fedora, CentOS,…) and also universal AppImages.

  2. Run the installation:

    • For DEB packages, use: sudo dpkg -i maptiler-server-x.x.x.deb
    • For RPM packages, use: sudo rpm -i maptiler-server-x.x.x.rpm
    • For AppImages, first allow the package to execute in file properties. (Alternatively, run chmod u+x maptiler-server-X.X.X-linux.AppImage.) Then double-click on the package to install it.

Run directly

When installed, start MapTiler Server:

maptiler-server

This command uses the current directory to start MapTiler Server, and generates a random password for the MapTiler Server administration. The password will be printed in the command line. Copy it and use it to sign in at http://localhost:3650/admin.

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

Run as a service

Optionally, you can configure and start MapTiler Server as a systemd service, so that it keeps running on the machine even after the current user signs out:

sudo maptiler-server-servicify

This command starts a script which guides you through setting up MapTiler Server’s working directory (use absolute path), port, and administration password. Then it creates the systemd service file and starts the service.

What’s next

If you’ve just installed MapTiler Server for the first time, we recommend our Getting Started with MapTiler Server to set up map hosting and quickly test it out. You’ll also learn how to set up MapTiler Server for real production deployment at the end of the guide.

MapTiler Server on Raspberry Pi

MapTiler Server supports the ARM64 architecture, so you can run it on Raspberry Pi minicomputers, among others. Before you start, please note:

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

If your device is compatible, make sure that Raspberry Pi OS (64-bit) is installed and wi-fi connection is set up. For help with these tasks, please refer to the official Raspberry Pi documentation.

To install MapTiler Server on Raspberry Pi OS, which is a Debian derivative, follow the instructions on this page for Debian Linux.