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

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

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!

⚙️ 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

🌐 Accessing the Web Interface

Once the installation is complete, restart your device and open a web browser on your computer or mobile device.

💡 Note: This step is the same whether you installed MapStruct manually or used the pre-configured image.

In the address bar, type:

http://[IP Address]/map/index.php

To find your IP address, use one of the following commands in the terminal:

hostname -I

or

ifconfig

or

ip a

Look for the IP address under the wlan0 or eth0 section.

Once entered, press Enter and you will be redirected to the MapStruct web interface.