3. Installation

freemapper ist ein einzelnes Programm ohne Installer.

1. Laden Sie auf der Release-Seite das Archiv für Ihr System herunter:

   • Windows: freemapper-…-windows-x86_64.zip
   • Mac mit Apple-Chip (M1 und neuer): freemapper-…-macos-arm64.tar.gz
   • Mac mit Intel-Prozessor: freemapper-…-macos-x86_64.tar.gz
   • Linux: freemapper-…-linux-x86_64.tar.gz

   Die .gz-Dateien und freemapper-update.json auf der Seite sind für freemapper update; Sie brauchen sie nicht.

2. Entpacken Sie das Archiv mit einem Doppelklick. Legen Sie den Ordner an einen festen Ort, z. B. Dokumente/freemapper.

3. Beim ersten Start warnt das System, weil das Programm nicht signiert ist:

   • Windows: „Der Computer wurde durch Windows geschützt“ → Weitere Informationen → Trotzdem ausführen.
   • macOS: „kann nicht geöffnet werden …“ → Systemeinstellungen › Datenschutz & Sicherheit → Trotzdem öffnen.

Merken Sie sich den vollständigen Pfad zum Programm, z. B. C:\Users\Anna\Documents\freemapper\freemapper.exe oder /Users/anna/Documents/freemapper/freemapper. Der Assistent braucht ihn.

Im Ordner liegen außer dem Programm die READMEs, die Lizenz, dieses Handbuch und AGENTS.md, eine Anleitung für KI-Assistenten (Kapitel 4).

Aktualisieren

freemapper update setzt die neueste Version an die Stelle des Programms. Der Pfad bleibt gleich, deshalb arbeitet ein Assistent, der freemapper über seinen Pfad kennt, ohne Änderung weiter. Die Versionen bis 0.11.0 können sich noch nicht selbst aktualisieren. Laden Sie dafür einmal wie in Schritt 1 das neueste Archiv herunter und ersetzen Sie das Programm in Ihrem Ordner durch das aus dem Archiv. Danach übernimmt der Befehl das.

./freemapper update

Der Befehl zeigt die neue Version, ihr Erscheinungsdatum, den Link zu den Versionshinweisen und die Downloadgröße und fragt Jetzt installieren? [j/N]. Nur j oder ja installiert (auch y und yes). Diese Schalter ändern, was er tut:

Prüfung vor dem Austausch. Jede Version bringt eine Liste ihrer Programmdateien mit Größe und SHA-256-Prüfsumme mit, signiert mit dem minisign-Schlüssel des Projekts. Den öffentlichen Teil dieses Schlüssels hat freemapper eingebaut. Es installiert nur, wenn Signatur und Prüfsummen stimmen; sonst meldet es den Fehler, und das alte Programm bleibt. Danach startet es das neue Programm einmal mit --version. Erst wenn das die erwartete Version nennt, nimmt das neue Programm den Platz des alten ein.

Die vorherige Version. Das ersetzte Programm bleibt neben dem neuen als freemapper.previous liegen (Windows: freemapper.previous.exe). --rollback tauscht die beiden zurück, ein zweites --rollback kehrt zur neueren zurück.

Programmordner. freemapper muss in seinen eigenen Ordner schreiben dürfen. Nach Administratorrechten fragt es nicht. Ist der Ordner schreibgeschützt, nennt die Meldung ihn; entpacken Sie die neue Version dann von Hand dort oder verschieben Sie freemapper in einen Ordner, in den Sie schreiben dürfen. Starten Sie freemapper über einen Link wie ~/.local/bin/freemapper, ersetzt die Aktualisierung die Datei, auf die der Link zeigt.

Selbst gebaut. Ein freemapper, das Sie selbst mit cargo gebaut haben, aktualisiert sich nicht selbst. freemapper update sagt dann nur, dass es mit git pull und cargo build --release --locked aktualisiert wird, und die tägliche Prüfung entfällt.

Die tägliche Prüfung

Nach find, init, select, fetch, run und permits, die ohnehin ins Netz gehen, prüft freemapper höchstens einmal am Tag, ob es eine neuere Version gibt. derive und export arbeiten ohne Netz und prüfen nicht. Die Prüfung läuft, während der Befehl arbeitet. Findet sie eine neuere Version, folgt nach der Ausgabe des Befehls eine Zeile auf der Fehlerausgabe (stderr):

freemapper 0.12.0 ist verfügbar (Sie haben 0.11.0). Aktualisieren mit: freemapper update

Die Zeile kann auch nach einer Fehlermeldung kommen; selbst im Modus install installiert freemapper dann nichts. Die Prüfung hat 3 Sekunden ab dem Start des Befehls, ein sehr schneller Befehl kann also bis zu 3 s länger dauern. Braucht die Prüfung länger, bricht freemapper sie ab. Eine abgebrochene oder fehlgeschlagene Prüfung zeigt nichts und zählt trotzdem für den Tag; ein Rechner ohne Internet fragt also einmal am Tag und nicht bei jedem Befehl. Zeit und Ergebnis der letzten Prüfung stehen in update-check.json im Zwischenspeicher.

Keine tägliche Prüfung gibt es mit --offline, wenn die Umgebungsvariable CI gesetzt ist (wie auf Build-Servern), im Modus off und in einem selbst gebauten freemapper.

Aktualisierungsmodus

freemapper update --mode install speichert den Modus in der Datei settings.toml:

• Windows: %APPDATA%\freemapper\settings.toml, z. B. C:\Users\Anna\AppData\Roaming\freemapper\settings.toml
• macOS: ~/Library/Application Support/freemapper/settings.toml
• Linux: ~/.config/freemapper/settings.toml, oder $XDG_CONFIG_HOME/freemapper/settings.toml, wenn diese Variable gesetzt ist

Die Datei enthält dann mode = "install" unter [update]. Die Umgebungsvariable FREEMAPPER_UPDATE mit off, notify oder install hat Vorrang vor der Datei, solange sie gesetzt ist; --mode sagt es dann. FREEMAPPER_CONFIG_DIR nennt einen anderen Ordner für die Datei. --mode geht auch in einem selbst gebauten freemapper, denn es schreibt nur die Datei.

Dauerhaft ausschalten lässt sich die Prüfung mit freemapper update --mode off, für eine Terminal-Sitzung mit FREEMAPPER_UPDATE=off.

Was freemapper sendet

Die Prüfung fragt bei github.com zwei kleine Dateien der neuesten Version ab: das Aktualisierungsmanifest freemapper-update.json und seine Signatur. GitHub leitet die Anfrage an seine Download-Server weiter, und freemapper folgt nur zu release-assets.githubusercontent.com und objects.githubusercontent.com. Eine Installation lädt dann von dort die Programmdatei für Ihr System. Jede Anfrage trägt nur den festen User-Agent freemapper/<Version> (+https://github.com/HenryJobst/freemapper), denselben wie bei den Geodaten. freemapper sendet keine Kennung, keine Projektdaten und nichts über Sie.

Mit einem Assistenten

Auch der MCP-Server prüft einmal am Tag, und er installiert nie von sich aus. Kennt er eine neuere Version, endet seine nächste Antwort an den Assistenten mit einem Hinweis für Sie. Der Assistent soll Sie dann fragen und erst nach Ihrer Zustimmung das Werkzeug install_update aufrufen. Das Werkzeug check_update prüft nur. Ein laufender MCP-Server behält die alte Version, bis der Assistent ihn neu startet; in Claude Desktop beenden Sie die App und öffnen sie wieder. AGENTS.md gibt dem Assistenten diese Regeln.

Die Gebietsseite im Browser zeigt eine Zeile mit dem Befehl, wenn die letzte tägliche Prüfung eine neuere Version gefunden hat. Die Seite selbst installiert nichts.