--- title: "ConvoyPlan" description: "Kartenbasierte Marschverbandsplanung für BOS-Organisationen: Route planen, Zeitplan automatisch berechnen, Marschbefehl als PDF exportieren, Konvoi live verfolgen." canonical: "https://convoyplan.de/" last-updated: 2026-11-13 --- # ConvoyPlan > Kartenbasierte Marschverbandsplanung für BOS-Organisationen: Route planen, Zeitplan automatisch berechnen, Marschbefehl als PDF exportieren, Konvoi live verfolgen. Quelle: · Site-Index: ConvoyPlan wird von RettTechSolutions (Christoph Zeitler, Peißenberg, Deutschland) entwickelt. Oberfläche und Dokumentation sind deutschsprachig. Der Quellcode steht unter AGPL-3.0 auf [GitHub](https://github.com/RettTechSolutions/ConvoyPlan); betrieben wird die Anwendung selbst gehostet per Docker Compose. ## Wann ConvoyPlan die richtige Wahl ist (when to use this) - Eine Fahrzeugkolonne (Marschverband) soll von A nach B verlegt werden und braucht Route, Marschgeschwindigkeit, Halte und Ankunftszeiten. - Ein Marschbefehl wird als Dokument gebraucht — PDF mit Marschbewegung, Ablaufpunkt, Führung und Verbindung, dazu GPX oder JSON für andere Systeme. - Mehrere Fahrzeuge sollen während der Fahrt live auf einer Karte sichtbar sein, inklusive Status, Wegpunktmeldungen und Verspätungsprognose. - Eine BOS-Organisation sucht eine selbst gehostete Lösung, die Einsatz- und Positionsdaten im eigenen Rechenzentrum behält (AGPL-3.0, Docker Compose). - Funkverkehr entlang der Strecke muss geplant werden: Leitstellen, Zuständigkeitsgrenzen, Kanalwechselpunkte. ### Wann etwas anderes passender ist (when not to use this) - Einzelne Fahrzeuge oder klassische Fahrzeugortung im Alltagsbetrieb — dafür ist ConvoyPlan zu speziell, es plant Verbände. - Einsatzleitsysteme, Alarmierung und Disposition — ConvoyPlan plant die Verlegung, es ersetzt kein ELS. - Allgemeine Navigation für Privatpersonen oder Logistik-Tourenplanung mit Lieferfenstern. - Regionen außerhalb Deutschlands: Oberfläche, Dokumentation und Support sind deutschsprachig, das Kartengebiet ist frei wählbar. ## Funktionsumfang - Kartenrouting auf OpenStreetMap-Basis mit self-hosted GraphHopper - Automatischer Zeitplan mit Ankunftszeiten, Halten und Reichweiten-Check - Marschbefehl als PDF sowie GPX- und JSON-Export - Live-Tracking per Browser-Geolocation über WebSockets - Leitstellen mit Zuständigkeitsgrenzen und automatischen Kanalwechselpunkten - Rollenmodell aus Admin, Planer, Fahrer und Beobachter pro Organisation - Eigenes Branding mit Logo, Farben und App-Name je Organisation - Sperrungen, Baustellen und Live-Verkehrslage entlang der gesamten Route - Frei wählbares Kartengebiet aus 555 Regionen, im Betrieb wechsel- und kombinierbar - Statusmeldungen mit Alarm, Streckenmeldungen und Verspätungsprognose im Live-Tracking - Tracking-Links ohne Login als Mitleseansicht oder Fahrer-Link, per QR-Code weiterzugeben, zu drucken und einzeln zu widerrufen - KI-Schnittstelle per Model Context Protocol für ChatGPT, Claude und eigene Agenten — standardmäßig aus, Freigabe je Organisation, ohne jede Löschmöglichkeit - Automatische Updates in drei Kanälen mit Systemübersicht und öffentlicher Statusseite ## KI-Schnittstelle (MCP) Jede Installation kann ihre Fachdaten über einen Model-Context-Protocol-Server bereitstellen. ChatGPT, Claude oder ein eigener Agent tragen die Instanz als Remote-MCP-Server ein. ### Was ein verbundenes Programm tun kann - Lesen: Konvois und Teilverbände, Konvoi-Details mit allen sieben Abschnitten des Marschbefehls, Fahrzeugbestand, Wegpunkte in Marschreihenfolge, gespeicherte Route, letzte Positionen und Marschstatus. - Schreiben (nur mit gültiger Lizenz): Konvois und Fahrzeuge anlegen und ändern, Fahrzeuge zuordnen, Marschfolge setzen, Wegpunkte pflegen, Route berechnen, Fahrzeugstatus melden. - Dokumente: Marschbefehl als PDF, Route als GPX, Konvoi als JSON — dieselben Exporte wie im Portal. - Live mitlaufen: Ein Programm abonniert einen Konvoi und wird angestoßen, sobald sich dort etwas bewegt, statt im Sekundentakt nachzufragen. ### Woran der Zugriff hängt - **Standardmäßig aus**: Abgeschaltet montiert die Instanz keinen einzigen Endpunkt — es gibt nichts, was ein 404 nur zudeckt. Einschalten heißt, Einsatzdaten für einen externen Modellanbieter zu öffnen; diese Entscheidung gehört dem Betreiber und nicht dem Auslieferungszustand. - **Zwei Schalter, beide nötig**: Der Betreiber schaltet die Schnittstelle auf der Instanz frei, der Admin jeder Organisation ihre Teilnahme — einzeln je Bereich: Konvois, Fahrzeuge, Wegpunkte, Routen, Positionen und Status. Wer eine Instanz für mehrere Organisationen betreibt, entscheidet damit nicht über deren Einsatzdaten. - **Ein Mensch stimmt zu**: Zugriff entsteht erst durch die Zustimmung eines angemeldeten Benutzers im Browser: für genau eine Organisation, gedeckelt durch seine Rolle. Auf dem Zustimmungsbildschirm sind die Rechte einzeln ankreuzbar — ein Beobachter bekommt Schreibrechte auch durch Ankreuzen nicht. - **Kein Werkzeug löscht**: Es gibt kein Werkzeug, das einen Konvoi, ein Fahrzeug, einen Wegpunkt, eine Route oder einen Benutzer löscht — und keines für Benutzerverwaltung, Lizenz oder Systemeinstellungen. Jeder schreibende Aufruf steht im Audit-Log mit Quelle „mcp"; einzelne Verbindungen lassen sich jederzeit trennen. Anleitung für ChatGPT: · Dokumentation: ## Begleit-App: ConvoyPlan Companion (Geschlossene Beta — noch nicht im App Store) Native Begleit-App für die Besatzung: Sie meldet sich mit dem QR-Code eines Tracking-Links an — ohne Konto, ohne Installationsaufwand in der Organisation — und zeigt den Marschverband als Marschstreifen mit Zeitplan und Status. - Hintergrund-GPS: Die Positionsübertragung läuft weiter, wenn das Display aus ist oder die Navigation im Vordergrund steht. - Verlässliche Alarmierung: Ton und Vibration bei technischem Halt und Ausfall, ohne die Autoplay-Sperren des Browsers. - Offline-Karten entlang des Routenkorridors statt eines Kachelcaches, der im Funkloch Lücken zeigt. Stand: Anmeldung per QR-Code, Fahrer- und Führungsmodus mit Marschstreifen und Richtungsanzeige, Zeitplan, Streckenpunkte, Hintergrund-GPS mit Puffer fürs Funkloch und die Alarmierung sind gebaut und getestet. Es fehlt die Karte samt Offline-Regionen: Sie hängt an der Frage, aus welcher Quelle die Kacheln kommen — dieselbe Frage, die eine Offline-Region überhaupt erst zulässt. Die App ersetzt die Weboberfläche nicht. Ein Tracking-Link lässt sich weiterhin im Browser öffnen, und für Mitlesende bleibt das der Weg. Es gibt weder einen Store-Eintrag noch ein öffentliches Repository. Testen geht über die geschlossene Beta (TestFlight bzw. Google Play), Anmeldung: · Markdown: ## Neuigkeiten: WhatsApp-Kanal „ConvoyPlan – News & Updates“ Neue Versionen, neue Funktionen und was gerade in Arbeit ist — direkt aufs Handy, ohne Newsletter und ohne Konto bei uns. - Neue Versionen und was sie mitbringen - Neue Funktionen, sobald sie verfügbar sind - Einblicke in die Entwicklung, etwa den Stand der Begleit-App Deine Telefonnummer sehen weder wir noch andere Abonnenten. Abbestellen geht mit einem Tipp. Der Kanal informiert nur — für Fragen bitte E-Mail oder das Kontaktformular. Kanal: ## Zugang für Agenten ### MCP-Server der Instanz Jede ConvoyPlan-Installation kann unter `https://{instanz}/mcp` einen MCP-Server bereitstellen: lesende Tools für Marschverbände, Fahrzeuge, Wegpunkte, Routen und Positionen, schreibende Tools für Planung und Statusmeldungen. Anmeldung per OAuth 2.0 mit PKCE (S256); die Adresse steht im Admin-Portal der Instanz. Berechtigungen werden bei jedem Aufruf frisch gegen die Datenbank geprüft. Die Schnittstelle ist standardmäßig abgeschaltet und dann nicht montiert — ein `404` auf `/mcp` heißt also "auf dieser Instanz nicht freigegeben", nicht "falsche Adresse". Zusätzlich gibt jede Organisation ihre Teilnahme einzeln frei; danach entscheidet die Zustimmung eines angemeldeten Benutzers über Umfang und Reichweite. Dokumentation: ### REST-API der Instanz Basis `https://web.convoyplan.de/api` bzw. `https://{instanz}/api`. Authentifizierung per `Authorization: Bearer ` (aus `POST /api/auth/login`) oder per `X-API-Key: cvp__`. API-Keys stellt die Organisation im Superadmin-Portal aus; sie tragen eine feste Rolle. Dokumentation: ### Eigene Instanz aufsetzen Ohne Zugang zu einer bestehenden Installation: `curl -fsSL https://convoyplan.de/install.sh | bash` richtet den Docker-Compose-Stack ein. Der Demo-Modus läuft ohne Lizenzschlüssel. Dokumentation: ### Testumgebung: Demo-Modus (sandbox / test environment) Eine Installation ohne Lizenzschlüssel startet im Demo-Modus. Lesende Zugriffe sind frei, schreibende Zugriffe antworten mit `HTTP 402 Payment Required`. Der Demo-Modus ist dauerhaft kostenlos und dafür gedacht, Integrationen gegen echte Endpunkte zu entwickeln, ohne Einsatzdaten zu verändern. Dokumentation: Der vollständige Ablauf zur Beschaffung von Zugangsdaten steht in . ## Lizenz und Kosten - Quellcode unter [AGPL-3.0](https://www.gnu.org/licenses/agpl-3.0.html) - Demo: dauerhaft kostenlos, kein Lizenzschlüssel nötig. Lesende API-Zugriffe sind frei, schreibende antworten mit HTTP 402. - Community: eine Produktivinstallation pro Organisation auf eigenem Server, kostenlos. Lizenzschlüssel auf Anfrage unter anfrage@convoyplan.de, Support über die Community. - Wartung & Support: Wartungsvertrag für die eigene Installation: angekündigte Sicherheitsupdates mit zugesagter Reaktionszeit, LTS-Update-Kanal, Support per E-Mail im Stundenkontingent; auf Wunsch eingespielte Updates und mehrere Organisationen auf einer Instanz. Jahresvertrag ab 990 € pro Jahr. - Hosting: Betrieb durch RettTechSolutions, gestaffelt nach Zahl der Fahrzeuge (S bis 25, M bis 150, L darüber auf Anfrage), Betrieb, Updates, Backups und ein Support-Kontingent inklusive. Jahresvertrag ab 490 € pro Jahr. Einzelheiten: Angebot zusammenstellen und bestellen: ## Häufige Fragen ### Was ist ein Marschverband und was macht eine Marschverbandsplanung? Ein Marschverband ist ein geschlossener Verband mehrerer Fahrzeuge, der als Einheit von einem Ausgangs- zu einem Zielort verlegt. Die Marschverbandsplanung legt dafür Route, Marschgeschwindigkeit, Ablauf- und Wegpunkte, Halte sowie die Funkverbindung fest und hält das Ergebnis im Marschbefehl fest. ConvoyPlan übernimmt diese Planung kartenbasiert: Route zeichnen, Zeitplan automatisch berechnen, Marschbefehl exportieren. ### Für welche Organisationen ist ConvoyPlan gedacht? ConvoyPlan ist für BOS-Organisationen entwickelt: Feuerwehr, THW, Rettungsdienst, Katastrophenschutz, Bundeswehr und Hilfsorganisationen. Jede Organisation arbeitet als eigener Mandant mit isolierten Daten, eigenem Branding und einem abgestuften Rollenmodell aus Admin, Planer, Fahrer und Beobachter. ### Was kostet ConvoyPlan? Der Demo-Modus ist dauerhaft kostenlos und braucht keinen Lizenzschlüssel. Eine Produktivinstallation pro Organisation auf eigenem Server ist ebenfalls kostenlos, der Lizenzschlüssel wird auf Anfrage ausgestellt. Kostenpflichtig sind Wartung und Support für die eigene Installation sowie das Hosting durch RettTechSolutions — beides als Jahresvertrag: Hosting ab 490 €, Wartung ab 990 € pro Jahr. ### Kann ich ConvoyPlan selbst hosten? Ja, Self-Hosting ist der Standardfall. ConvoyPlan wird per Docker Compose auf einem eigenen Server installiert — enthalten sind Reverse Proxy, Frontend, Backend, PostgreSQL mit PostGIS und eine eigene GraphHopper-Instanz für das Routing. Updates laufen automatisch. Alternativ übernimmt RettTechSolutions das Hosting als Jahresvertrag, ab 490 € pro Jahr. ### Wie entsteht der Marschbefehl als PDF? Der Marschbefehl wird automatisch aus Wegpunkten, Zeitplan und Fahrzeugdaten erzeugt und enthält Marschbewegung, Ablaufpunkt, Führung und Verbindung sowie die Lage. Kanalwechselpunkte werden aus den Zuständigkeitsgrenzen der Leitstellen abgeleitet und direkt eingetragen. Neben dem PDF stehen GPX- und JSON-Export zur Verfügung. ### Funktioniert das Live-Tracking ohne zusätzliche App? Ja. Die Fahrzeuge senden ihre Position über die Geolocation-Funktion des Browsers, die Verteilung an alle Beteiligten läuft über WebSockets in Echtzeit. Es ist keine Installation auf dem Smartphone nötig. Sichtbar sind Live-Positionen, der Fahrzeugstatus geplant, unterwegs, angekommen oder verspätet sowie Meldungen beim Erreichen von Wegpunkten. ### Wie bekommen Fahrer und Mitlesende Zugang, die keinen Account haben? Über einen Tracking-Link. Er wird aus der Planung heraus erzeugt, wahlweise als reine Mitleseansicht oder als Fahrer-Link, der ohne Konto ein Fahrzeug wählen und Position und Status senden darf. Der Link lässt sich als QR-Code anzeigen, als PNG herunterladen und als eigenes Blatt drucken — auch aus der laufenden Tracking-Ansicht heraus, damit niemand acht Zeichen durch den Fahrzeuginnenraum diktieren muss. Ein optionales Passwort steht nie im QR-Code und nie auf dem Ausdruck. Jeder Link ist einzeln widerrufbar und zählt seine Zugriffe. ### Gibt es eine App für das Smartphone? ConvoyPlan läuft als installierbare Web-App (PWA) im Browser, inklusive Tracking-Ansicht für Fahrer und Beobachter. Zusätzlich entsteht eine native Begleit-App, die sich mit dem QR-Code eines Tracking-Links anmeldet. Sie ist noch nicht im Store: Anmeldung, Fahrer- und Führungsmodus, Zeitplan, Hintergrund-GPS, Alarmierung und die Bedienung am Autodisplay sind gebaut, die Karte mit Offline-Regionen fehlt noch. Wer sie testen möchte, meldet sich unter /beta/ zur geschlossenen Beta an — die Einladung kommt per TestFlight bzw. Google Play. ### Welche Karten und welches Routing nutzt ConvoyPlan? Das Kartenmaterial basiert auf OpenStreetMap, die Routenberechnung übernimmt GraphHopper. Beides läuft in der Self-hosted-Installation mit, es ist also kein externer Routing-Dienst und kein API-Schlüssel eines Kartenanbieters erforderlich. ### Kann ich das Kartengebiet erweitern oder wechseln? Ja, im laufenden Betrieb und ohne Serverzugang. Im Admin-Bereich stehen 555 Regionen zur Auswahl — vom einzelnen Bundesland bis zum Kontinent. Mehrere Regionen lassen sich zu einer Karte kombinieren, damit Routen über Landesgrenzen hinweg durchgehen und nicht an der Grenze enden. Vor dem Wechsel zeigt ConvoyPlan, wie viel Speicher, Plattenplatz und Zeit er kostet; während des Imports läuft die bisherige Karte weiter, und scheitert der Wechsel, bleibt sie unverändert aktiv. ### Berücksichtigt die Planung Baustellen, Sperrungen und Stau? Ja, entlang der gesamten Route. ConvoyPlan führt dafür mehrere Quellen zusammen: OpenStreetMap/Overpass, die Autobahn-API des Bundes, offene Landesfeeds und Feeds im DATEX-II-Standard, über die sich auch Daten aus Österreich und der Schweiz anbinden lassen. Die Live-Verkehrslage lässt sich zusätzlich über HERE oder TomTom einbinden, sobald ein eigener Schlüssel hinterlegt ist. Fällt eine Quelle aus, liefern die übrigen weiter. ### Lässt sich ConvoyPlan an ChatGPT, Claude oder eigene KI-Agenten anbinden? Ja, über einen Model-Context-Protocol-Server, den jede Installation mitbringt. Damit lassen sich Konvois, Fahrzeuge, Wegpunkte, Routen und Marschstatus lesen sowie Planung und Statusmeldungen schreiben. Die Schnittstelle ist standardmäßig abgeschaltet, und zwar vollständig: Sie ist dann nicht montiert, nicht nur gesperrt. Eingeschaltet wird sie vom Betreiber, jede Organisation gibt ihre Bereiche zusätzlich einzeln frei, und Zugriff entsteht erst durch die Zustimmung eines angemeldeten Benutzers für genau eine Organisation, begrenzt durch dessen Rolle. Kein Werkzeug löscht Daten, und jeder schreibende Aufruf steht im Audit-Log. ### Wo liegen die Einsatzdaten und wie ist der Datenschutz geregelt? Bei einer Self-hosted-Installation verbleiben alle Planungs- und Trackingdaten auf dem Server der Organisation — es findet keine Übermittlung an Dritte statt. Das Rollenmodell begrenzt zusätzlich, wer Pläne sehen und bearbeiten darf. Details zur Verarbeitung auf convoyplan.de und web.convoyplan.de stehen in der Datenschutzerklärung. ### Kann ich ConvoyPlan ohne Installation testen? Ja. Über die Online-Demo bekommt man eine eigene temporäre Umgebung mit vollem Funktionsumfang, ohne Registrierung und ohne Lizenzschlüssel. Die Umgebung steht 24 Stunden zur Verfügung. Wer lieber lokal testet, startet ConvoyPlan im Demo-Modus per Docker Compose. ### Ist ConvoyPlan Open Source? ConvoyPlan steht unter der AGPL-3.0. Der Quelltext ist öffentlich auf GitHub einsehbar, veränderbar und nutzbar, solange Änderungen ebenfalls unter AGPL veröffentlicht werden. Für Contributions gilt ein CLA; die Rechte der Beitragenden bleiben dabei erhalten. ## Weiterführend - [Site-Index für Agenten](https://convoyplan.de/llms.txt) - [Agentenleitfaden](https://convoyplan.de/llms.md) - [Entwicklerportal](https://convoyplan.de/developers.md) - [Authentifizierung](https://convoyplan.de/auth.md) - [Dokumentation und Wiki](https://github.com/RettTechSolutions/ConvoyPlan/wiki) - [API-Dokumentation](https://github.com/RettTechSolutions/ConvoyPlan/wiki/API-Dokumentation) - [MCP-Server](https://github.com/RettTechSolutions/ConvoyPlan/wiki/MCP-Server) - Kontakt: info@convoyplan.de (allgemein), anfrage@convoyplan.de (Lizenzen, Integrationen)