function Sidebar() { return ( ); }

MapStruct

MapStruct Logo

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

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