MapStructur – Self-hosted map editor with draggable markers and Docker support

0 3 minutes read

MapStruct: Create and Customize Interactive Maps

Easily insert background maps, create multiple pages, place markers, and add links.

MapStruct is a modern, interactive tool designed for creating custom maps.
With MapStruct, you can upload your own background images to serve as maps,
organize different views across multiple pages, and place interactive markers.

Enhance your maps by adding links to markers so that users can access additional information or navigate to other pages.
The intuitive drag & drop interface makes designing engaging maps both simple and efficient.

Explore MapStruct

Discover the interactive features of MapStruct in our demo area.

Open MapStruct Demo

Key Features of MapStruct

Insert Maps
- Upload custom background images to serve as maps.
- Adjust settings for optimal map display.
Create Multiple Pages
- Organize different map views on separate pages.
- Switch between pages effortlessly.
Place Markers
- Add interactive markers by clicking on the map.
- Drag and drop markers to adjust their positions.
Add Links
- Attach internal or external links to markers.
- Create a connected, interactive map experience.

How Does MapStruct Work?

Upload a background image to use as your map.
Create multiple pages to organize various views.
Click on the map to place and customize markers.
Add links to markers to provide further information or navigation.
Enjoy an intuitive drag & drop interface for a seamless mapping experience.

Who Benefits from MapStruct?

Event Planners – Create interactive maps for venues and guided tours.
Real Estate Professionals – Showcase properties with detailed maps.
Tourism Agencies – Develop engaging digital maps and travel guides.
Educational Institutions – Build interactive campus maps for students and visitors.

Get Started with MapStruct

MapStruct simplifies the process of creating interactive maps.
Upload your background map, organize multiple pages, place markers, and add links—all through an intuitive interface.

Start today and elevate your map projects to the next level.

Prefer containers? MapStruct is also available as a ready-to-use Docker container.
Pull the image with:

docker pull itfourall/mapstructur

Run container:

docker run -d -p 8080:80 --name mapstructur itfourall/mapstructur

View it on Docker Hub
Ideal for fast deployment on any system that supports Docker – no manual setup required!

For advanced users, a manual installation script is also available. (See below)

Recommended OS:

Raspberry Pi Desktop for PC and Mac

Based on Debian, this OS includes the full Raspberry Pi Desktop and official tools. It is perfect for use on physical hardware, servers, or inside virtual machines.

Installation with Auto-Installer (Recommended)

Install MapStruct quickly using our auto-installer script.

First, install a compatible Linux system (e.g. Raspberry Pi Desktop for PC and Mac, Raspberry Pi OS, Debian, Ubuntu…)
Note: The recommended OS already includes the sudo package by default.
If you’re using a different distribution, make sure sudo is installed before running any commands.
How to install it? Click here.
Open the terminal or connect via SSH (e.g. with PuTTY).
Now enter the following commands one by one:

You need root rights!!!

How to install it “sudo”? Click here.

apt install sudo -y

sudo apt install wget -y

sudo wget -O - https://raw.githubusercontent.com/IT-4-ALL/mapstructur/refs/heads/main/start.sh | sed 's/r$//' | bash

Tip: If you’re unsure which OS to use, we recommend

Raspberry Pi Desktop for PC and Mac
– it’s based on Debian, lightweight, and works perfectly with MapStruct on laptops, servers, or VMs.

View official OS documentation and image download:
Raspberry Pi OS Release Notes