BoatOS Ecosystem – Free Marine OS for Makers

What BoatOS doesWas BoatOS kann

Everything in one systemAlles in einem System

No subscriptions. No cloud dependency. Everything runs locally on the Pi — offline first, always. Items marked Beta ship on the beta update channel, Dev is still in the development branch.

Keine Abonnements. Keine Cloud-Abhängigkeit. Alles läuft lokal auf dem Pi — offline-first, immer. Punkte mit Beta laufen im Beta-Update-Kanal, Dev steckt noch im Entwicklungszweig.

🗺️

Offline NavigationOffline-Navigation

OpenSeaMap vector tiles stored locally on SSD. Works without mobile signal. Fairways, locks, buoys — all offline.

OpenSeaMap-Vektorkacheln lokal auf SSD. Funktioniert ohne Mobilfunk. Wasserstraßen, Schleusen, Tonnen — alles offline.

🧭

Inland Routing with LocksBinnen-Routing mit Schleusen

OSRM tuned for rivers and canals — not roads. Locks along the route with opening hours and phone numbers, ETA including lock waiting time and current.

OSRM auf Flüsse und Kanäle getrimmt — nicht auf Straßen. Schleusen entlang der Route mit Betriebszeiten und Telefonnummern, ETA inklusive Schleusenwartezeit und Strömung.

📜

Official Inland ChartsAmtliche Binnenkarten Beta

Inland ENC from the German waterways authority (ELWIS), downloaded and converted on the Pi. Depth areas, fairway, bridges and weirs with clearance heights, CEVNI signs, buoyage, kilometre marks — in Deck and Helm.

Amtliche Inland-ENC der WSV (ELWIS), auf dem Pi geladen und konvertiert. Tiefenbereiche, Fahrrinne, Brücken und Wehre mit Durchfahrtshöhen, CEVNI-Zeichen, Betonnung, Kilometrierung — in Deck und Helm.

⚠️

Route Hazard CheckRouten-Hindernis-Warnung Beta

Every calculated route is checked against the official chart data: bridges too low for your air draft, shallows against your draft — corrected by the live water level — and weirs. Shown as markers plus a warning panel.

Jede berechnete Route wird gegen die amtlichen Kartendaten geprüft: zu niedrige Brücken für deine Durchfahrtshöhe, Flachstellen gegen den Tiefgang — korrigiert um den Live-Pegel — und Wehre. Als Marker plus Warn-Panel.

⚓

AIS — Live TrafficAIS — Live-Verkehr

Other vessels on the chart in real time. Via AISStream.io over internet or local USB AIS receiver.

Andere Schiffe in Echtzeit auf der Karte. Über AISStream.io per Internet oder lokalen USB-AIS-Empfänger.

📊

Engine MonitoringMotorüberwachung

Battery, oil temp, oil pressure, coolant, RPM — all live. Alarms when something is wrong. Works with old analogue VDO sensors.

Batterie, Öltemp, Öldruck, Kühlwasser, Drehzahl — alles live. Alarm wenn etwas nicht stimmt. Funktioniert mit alten analogen VDO-Gebern.

📝

Automatic LogbookAutomatisches Logbuch

Every trip recorded automatically — GPS track, sensor data, weather snapshot. After one season: a complete record.

Jede Fahrt automatisch aufgezeichnet — GPS-Track, Sensordaten, Wetter-Snapshot. Nach einer Saison: ein vollständiges Protokoll.

🌦️

Weather + Water LevelsWetter + Pegel

Official DWD severe weather warnings (via Bright Sky), OpenWeather optional. Weather follows your actual position. PEGELONLINE water levels for inland waterways — live.

Amtliche DWD-Unwetterwarnungen (über Bright Sky), OpenWeather optional. Wetter folgt der tatsächlichen Position. PEGELONLINE-Pegelstände für Binnenwasserstraßen — live.

📱

Two FrontendsZwei Oberflächen

Helm: Flutter native on the touchscreen. Deck: browser frontend — open on any phone, no install needed.

Helm: Flutter nativ auf dem Touchscreen. Deck: Browser-Frontend — auf jedem Handy öffnen, keine Installation nötig.

🆘

SOS / MOB Button

Man-overboard and emergency button in both Helm and Deck. One tap, position logged, alarm triggered.

Mann-über-Bord- und Notfall-Button in Helm und Deck. Ein Tipp, Position gespeichert, Alarm ausgelöst.

💥

Impact DetectionAufprallerkennung

MPU6050 logs every impact with timestamp, GPS position and severity. Born from an unplanned encounter with a rock.

MPU6050 protokolliert jeden Aufprall mit Zeitstempel, GPS-Position und Schwere. Entstanden aus einer unbeabsichtigten Begegnung mit einem Felsen.

🗺️

60+ Map Regions60+ Kartenregionen

MBTiles Creator tool for Windows — no Python, no terminal. Select region, create map, upload to Pi. Done. Several regions side by side, switchable in Deck.

MBTiles-Creator-Tool für Windows — kein Python, kein Terminal. Region auswählen, Karte erstellen, auf den Pi laden. Fertig. Mehrere Regionen nebeneinander, in Deck umschaltbar.

🌙

Night ModeNacht-Rotlicht-Modus

Three brightness stages down to a red-light theme with a red chart filter — keeps your night vision intact on a dark bridge.

Drei Helligkeitsstufen bis zum Rotlicht-Theme samt Rotfilter über der Karte — die Nachtsicht bleibt im dunklen Steuerhaus erhalten.

⚓

Marinas, Anchorages & TidesHäfen, Ankerplätze & Gezeiten Beta

Harbours and anchorages as pins with berths, VHF channel and services — pre-imported every 48 h, so they work offline. Tidal curve of the nearest gauge with trend and last high/low water.

Häfen und Ankerplätze als Pins mit Liegeplätzen, UKW-Kanal und Service — alle 48 h vorab importiert, damit sie offline funktionieren. Tidenkurve der nächsten Pegelstation mit Trend und letztem Hoch-/Niedrigwasser.

💨

Wind Along the RouteWind entlang der Route Dev

Wind arrows at each waypoint showing the forecast for its own ETA, colour-coded by strength, with gusts in the popup. Cached to file, so it stays usable without internet.

Windpfeile an jedem Stützpunkt — je Punkt die Vorhersage zur eigenen ETA, farbcodiert nach Stärke, Böen im Popup. Datei-Cache, damit es ohne Internet nutzbar bleibt.

🔄

Stable and Beta ChannelStable- und Beta-Kanal

The built-in updater has two channels. Stay on stable, or switch to beta in the settings to get new features early — one tap, both directions.

Der eingebaute Updater hat zwei Kanäle. Auf Stable bleiben oder in den Einstellungen auf Beta wechseln, um neue Funktionen früher zu bekommen — ein Tipp, in beide Richtungen.

Get startedLoslegen

From zero to sailing in 30 minutesVon null zum Segeln in 30 Minuten

No Linux knowledge required. No terminal. No setup wizard. Flash, boot, done.

Keine Linux-Kenntnisse erforderlich. Kein Terminal. Kein Setup-Assistent. Flashen, booten, fertig.

Download the imageImage herunterladen

Get the latest BoatOS image from archive.org (~7.5 GB). The image contains everything — OS, all services, map data for Germany, OTA updater. Anything newer than the image is pulled in later by the updater.

Lade das neueste BoatOS-Image von archive.org (~7,5 GB). Das Image enthält alles — OS, alle Dienste, Kartendaten für Deutschland, OTA-Updater. Alles Neuere als das Image holt der Updater später nach.

⬇ boatos_v1.7.0.img.gz

Flash with Balena EtcherMit Balena Etcher flashen

Use Balena Etcher (free, Windows/Mac/Linux) — select the .img.gz file, select your SSD or SD card, click Flash. Like flashing any USB stick.

Nutze Balena Etcher (kostenlos, Windows/Mac/Linux) — .img.gz-Datei auswählen, SSD oder SD-Karte auswählen, Flash klicken. Wie das Flashen eines USB-Sticks.

Configure WiFi before first bootWLAN vor dem ersten Start konfigurieren

After flashing, open the SSD/SD card on your computer and edit wlan.txt in the root directory:

Nach dem Flashen die SSD/SD-Karte am Computer öffnen und wlan.txt im Hauptverzeichnis bearbeiten:

SSID=YourBoatNetwork
PASSWORD=YourPassword

Insert and power onEinsetzen und einschalten

Insert the SSD/SD into the Pi, connect the touchscreen and GPS mouse, power on. BoatOS boots automatically. GPS position appears once the mouse has a fix.

SSD/SD in den Pi einsetzen, Touchscreen und GPS-Maus anschließen, einschalten. BoatOS startet automatisch. GPS-Position erscheint, sobald die Maus einen Fix hat.

Access from phone or tabletVom Handy oder Tablet aufrufen

Connect your device to the same network as the Pi, open a browser, type the Pi's IP address. Deck opens — full chart and monitoring in the browser.

Gerät mit demselben Netzwerk wie der Pi verbinden, Browser öffnen, IP-Adresse des Pi eingeben. Deck öffnet — vollständige Karte und Monitoring im Browser.

http://192.168.x.x:8000

Stay up to dateAuf dem neuesten Stand bleiben

BoatOS has a built-in OTA updater. New versions are applied on demand from the settings menu — no reflashing needed. Pick your channel under Settings → System → Update channel: stable for released versions, beta to get the v1.8 pre-releases early. You can switch back at any time.

BoatOS hat einen eingebauten OTA-Updater. Neue Versionen werden auf Anforderung über das Einstellungsmenü eingespielt — kein Neuflashen erforderlich. Kanal wählen unter Einstellungen → System → Update-Kanal: stable für freigegebene Versionen, beta für die v1.8-Vorabversionen. Der Wechsel geht jederzeit in beide Richtungen.

DocumentationDokumentation

Setup guidesEinrichtungsanleitungen

Detailed instructions for each project in the ecosystem.

Detaillierte Anleitungen für jedes Projekt im Ökosystem.

Hardware RequirementsHardware-Anforderungen

Recommended: Raspberry Pi 4 (4GB), 10.1" HDMI touchscreen, BU-353N5 GPS mouse, 128GB SSD, DC-DC 12V→5V converter. Also supported: Pi 3B+, Pi 5, Zero 2W.

Empfohlen: Raspberry Pi 4 (4 GB), 10,1" HDMI-Touchscreen, BU-353N5 GPS-Maus, 128 GB SSD, DC-DC 12V→5V-Wandler. Auch unterstützt: Pi 3B+, Pi 5, Zero 2W.

Recommended SetupEmpfohlenes Setup

Connect Pi via LAN cable to your onboard router for maximum stability
Use an SSD instead of SD card — more reliable under voltage fluctuations
Dedicated onboard router keeps the boat network separate from marina WiFi
GPS mouse needs a clear view of the sky — mount outside or near a hatch

Pi per LAN-Kabel mit dem Bordrouter verbinden — maximale Stabilität
SSD statt SD-Karte verwenden — zuverlässiger bei Spannungsschwankungen
Eigener Bordrouter hält das Bootnetz vom Marina-WLAN getrennt
GPS-Maus braucht freie Sicht zum Himmel — außen oder nahe einer Luke montieren

Update ChannelsUpdate-Kanäle

The updater knows two channels, switchable under Settings → System in both Helm and Deck:

Der Updater kennt zwei Kanäle, umschaltbar unter Einstellungen → System in Helm und Deck:

stable — released versions only. Currently v1.7.3. This is the default and what the image ships with.
beta — pre-releases as well. Currently the v1.8 line, which carries the official inland charts and the route hazard check.

stable — nur freigegebene Versionen. Aktuell v1.7.3. Standard und das, womit das Image ausgeliefert wird.
beta — auch Vorabversionen. Aktuell die v1.8-Linie mit den amtlichen Binnenkarten und der Routen-Hindernis-Warnung.

Switching back to stable is safe — the updater picks the newest version of the selected channel, so the next stable release brings you back onto the released line.

Der Rückweg auf stable ist unkritisch — der Updater nimmt die neueste Version des gewählten Kanals, das nächste Stable-Release holt dich also wieder auf die freigegebene Linie.

OTA Update Workaround (v1.6.2 image and older)OTA-Update-Workaround (Image v1.6.2 und älter)

Not needed on the v1.7.0 image. If OTA update hangs on an older image, run this once via terminal or PowerShell:

Beim v1.7.0-Image nicht nötig. Falls der OTA-Update auf einem älteren Image hängt, einmalig im Terminal oder PowerShell ausführen:

ssh boatos@boatos.local "rm ~/BoatOS/scripts/update.sh"

Default password: boatos123 (change this!). Then start the update from Helm or Deck settings.

Standard-Passwort: boatos123 (bitte ändern!). Danach Update in den Helm- oder Deck-Einstellungen starten.

Change Default PasswordStandard-Passwort ändern

ssh boatos@boatos.local
passwd

What is BoatOpenIO?Was ist BoatOpenIO?

BoatOpenIO is a modular sensor IO system for connecting old analogue marine sensors (VDO temperature, oil pressure, tank senders) to BoatOS via MQTT. 16 channels, stackable mini-boards per channel for signal conditioning.

BoatOpenIO ist ein modulares Sensor-IO-System zum Anschluss alter analoger Bordsensoren (VDO-Temperatur, Öldruck, Tankgeber) an BoatOS via MQTT. 16 Kanäle, stapelbare Mini-Boards je Kanal zur Signalaufbereitung.

Hardware

ESP32 DevKit (main controller)
CD74HC4067 MUX (16:1 multiplexer)
Up to 4× ADS1115 (16-bit ADC, I2C addresses 0x48–0x4B)
MPU6050 (tilt + impact detection)
Mini-boards: voltage divider, pull-up/down, optocoupler, pulse counter

⚠️ Important Warning⚠️ Wichtiger Hinweis

Always verify which mini-board is plugged into which channel before applying power. Connecting 12V directly to a pull-up channel (instead of through a voltage divider) will destroy the MUX, all ADS1115 and the ESP32 through I2C chain reaction. Cost: ~€50. The protection circuit (Zener diodes) is planned for the final PCB version.

Immer prüfen, welches Mini-Board in welchem Kanal steckt, bevor Spannung angelegt wird. 12V direkt an einen Pull-up-Kanal (statt über Spannungsteiler) zerstört durch I2C-Kettenreaktion MUX, alle ADS1115 und den ESP32. Kosten: ~50 €. Die Schutzschaltung (Zener-Dioden) ist für die finale PCB-Version geplant.

First StartErster Start

On first boot, BoatOpenIO opens a WiFi access point BoatOpenIO-Setup. Connect with your phone, open 192.168.4.1, enter WiFi and MQTT credentials. BoatOS auto-discovers all sensor channels.

Beim ersten Start öffnet BoatOpenIO den WLAN-Zugangspunkt BoatOpenIO-Setup. Mit dem Handy verbinden, 192.168.4.1 aufrufen, WLAN- und MQTT-Zugangsdaten eingeben. BoatOS erkennt alle Sensorkanäle automatisch.

What is ValveHeater?Was ist ValveHeater?

Modular frost protection heating rings for valves and pipes. Hinged clamshell design, velcro fastening, 12V heating foil (14W per ring), ESP32 controller with MQTT and BoatOS integration.

Modulare Frostschutz-Heizringe für Ventile und Leitungen. Scharnier-Klappschale, Klett-Befestigung, 12V-Heizfolie (14 W je Ring), ESP32-Controller mit MQTT und BoatOS-Integration.

InstallationMontage

Open ring, place around valve or pipe, close velcro. Under 1 minute per ring.
Run cable to controller terminal block
Mount controller in accessible location in engine room
Connect 12V supply, fuse with 10A
First start: WiFiManager AP opens for configuration

Ring öffnen, um Ventil oder Leitung legen, Klett schließen. Unter 1 Minute pro Ring.
Kabel zur Controller-Klemmleiste führen
Controller an zugänglicher Stelle im Motorraum montieren
12V anschließen, mit 10A absichern
Erster Start: WiFiManager-AP öffnet sich zur Konfiguration

3D Print3D-Druck

Print in ASA (heat resistant to ~95°C, UV stable) or PETG as alternative. Do not use PLA — softens above 60°C. STL files and print parameters in the GitHub repository.

Druck in ASA (hitzebeständig bis ~95 °C, UV-stabil) oder PETG als Alternative. Kein PLA — erweicht ab 60 °C. STL-Dateien und Druckparameter im GitHub-Repository.

BoatOS Dashboard

ValveHeater sends all data via MQTT. BoatOS auto-discovers the topics and displays temperature, ring status, and remote control buttons in the dashboard.

ValveHeater sendet alle Daten per MQTT. BoatOS erkennt die Topics automatisch und zeigt Temperatur, Ring-Status und Fernsteuerungs-Buttons im Dashboard.

MBTiles Creator (Windows)

Standalone Windows tool for creating offline map tiles. No Python, no terminal required. Shipped with every release — the link below always fetches the current one.

Eigenständiges Windows-Tool zum Erstellen von Offline-Kartenkacheln. Kein Python, kein Terminal erforderlich. Liegt jedem Release bei — der Link unten holt immer die aktuelle Fassung.

⬇ Download BoatOS-MBTiles-Creator.exe
Run the .exe — Java (planetiler) downloads automatically on first start
Select your region from 60+ options (all German states, Scandinavia, UK, Ireland, USA, Canada, Australia…)
Enter your BoatOS IP address, click Create & Upload — the tool converts and uploads directly to your Pi
Note: if you save or download the .mbtiles manually, you need to upload it yourself via Deck (Settings → Maps → Upload)

⬇ BoatOS-MBTiles-Creator.exe herunterladen
.exe ausführen — Java (planetiler) wird beim ersten Start automatisch geladen
Region aus 60+ Optionen auswählen (alle deutschen Bundesländer, Skandinavien, UK, Irland, USA, Kanada, Australien…)
BoatOS-IP eingeben, Erstellen & Hochladen klicken — das Tool konvertiert und lädt direkt auf den Pi
Hinweis: Wenn du die .mbtiles-Datei manuell speicherst oder herunterlädst, musst du sie selbst hochladen: Deck → Einstellungen → Karten → Hochladen

Multiple RegionsMehrere Regionen

BoatOS holds several map regions at once. Upload several .mbtiles files and switch between them in Deck. Since v1.7 the routing graph follows the region — change the map, and routes are calculated on that region's waterways.

BoatOS hält mehrere Kartenregionen gleichzeitig vor. Mehrere .mbtiles-Dateien hochladen und in Deck zwischen ihnen wechseln. Seit v1.7 folgt der Routing-Graph der Region — Karte wechseln, und Routen werden auf den Wasserstraßen dieser Region berechnet.

Manual Download (advanced)Manueller Download (Fortgeschrittene)

Experienced users can download .mbtiles files directly from OpenSeaMap or create them with tilemaker on Linux/Mac.

Erfahrene Nutzer können .mbtiles-Dateien direkt von OpenSeaMap herunterladen oder mit tilemaker unter Linux/Mac erstellen.

Inland ENC from ELWISInland-ENC von ELWIS

Beyond the OpenStreetMap-based offline maps, BoatOS can use the official Inland ENC published by the German waterways administration (WSV) via ELWIS. These are the same charts the professional inland skippers use — and they are free.

Neben den OpenStreetMap-basierten Offline-Karten kann BoatOS die amtlichen Inland-ENC der Wasserstraßen- und Schifffahrtsverwaltung (WSV) über ELWIS nutzen. Das sind dieselben Karten, mit denen die Berufsschifffahrt fährt — und sie sind kostenlos.

Beta This is part of the v1.8 line. Switch the update channel to beta in Settings → System to get it.

Beta Gehört zur v1.8-Linie. Update-Kanal in Einstellungen → System auf beta stellen, um sie zu bekommen.

How to get themSo kommen sie aufs Boot

Open Settings → Charts in Deck and press Load catalogue — BoatOS reads the ELWIS catalogue and lists the available chart cells
Tick the waterways you sail and start the download; it runs as a background job with progress, so you can keep using the chart
The S-57 cells are converted to vector tiles on the Pi — nothing leaves your boat, and nothing needs a desktop GIS
The catalogue is cached, so a temporary ELWIS outage does not block you

In Deck Einstellungen → Seekarten öffnen und Katalog laden drücken — BoatOS liest den ELWIS-Katalog und listet die verfügbaren Kartenblätter
Die eigenen Reviere anhaken und den Download starten; er läuft als Hintergrund-Job mit Fortschritt, die Karte bleibt nutzbar
Die S-57-Zellen werden auf dem Pi in Vektorkacheln umgewandelt — nichts verlässt das Boot, kein Desktop-GIS nötig
Der Katalog wird zwischengespeichert, ein ELWIS-Ausfall blockiert also nicht

What you see on the chartWas auf der Karte erscheint

Depth areas and the fairway boundary
Bridges, weirs and overhead cables with their clearance heights
Inland traffic signs (CEVNI), buoyage and beacons, kilometre marks
Click any object for its chart attributes — in Deck and in Helm

Tiefenbereiche und Fahrrinnengrenze
Brücken, Wehre und Freileitungen mit Durchfahrtshöhen
Schifffahrtszeichen (CEVNI), Betonnung und Baken, Kilometrierung
Klick auf ein Objekt zeigt seine Kartenattribute — in Deck und in Helm

Route hazard checkRouten-Hindernis-Warnung

Enter your height and draft once under Settings → Boat. After every route calculation BoatOS checks the route against the chart data and flags bridges you do not fit under, shallows below your draft — corrected by the live water level — and weirs. Warnings appear as markers on the chart plus a list you can walk through.

Höhe und Tiefgang einmalig unter Einstellungen → Boot eintragen. Nach jeder Routenberechnung prüft BoatOS die Route gegen die Kartendaten und markiert Brücken, unter die das Boot nicht passt, Flachstellen unter dem Tiefgang — korrigiert um den Live-Pegel — und Wehre. Die Warnungen erscheinen als Marker auf der Karte plus als Liste zum Durchgehen.

CoverageAbdeckung

ELWIS covers the German federal waterways. Outside Germany BoatOS falls back to the OpenStreetMap/OpenSeaMap layers described in the Offline Maps tab.

ELWIS deckt die deutschen Bundeswasserstraßen ab. Außerhalb Deutschlands greift BoatOS auf die OpenStreetMap-/OpenSeaMap-Ebenen aus dem Reiter Offline-Karten zurück.

The free Marine OSfor boat makers Das freie Marine OSfür Bootsbauer

Four projects. One platform.Vier Projekte. Eine Plattform.

BoatOS

BoatOpenIO

ValveHeater

AutoSat