☠ PirateBox – dein eigenes Offline-Netz auf einem ESP32

Version 3.1 · für ESP32-S3 (z. B. ESP32-S3-Zero, ESP32-S3-DevKitC) und ESP8266 D1 Mini

Die PirateBox verwandelt einen kleinen Mikrocontroller in einen eigenen WLAN-Hotspot mit Chat, Dateiablage und Wiki. Alles läuft komplett ohne Internet: Wer sich mit dem offenen WLAN verbindet, landet automatisch auf der Startseite und kann mit allen anderen in der Nähe chatten, Dateien teilen und gemeinsam Notizen schreiben. Ideal für Zeltlager, LAN-Partys, Workshops, Festivals oder einfach als Spielerei im Piraten-Look.

Funktionen

📡 Offenes WLAN mit automatischer Weiterleitung (Captive Portal) – kein Passwort, keine App nötig
💬 Kajüten-Gespräche: Live-Chat für alle im Netz, Verlauf bleibt nach Neustart erhalten
📦 Schatzkiste: Dateien hochladen und herunterladen, auf Wunsch auf SD-Karte
📖 Logbuch: gemeinsames Wiki mit einfacher Formatierung (Überschriften, fett, Listen, Links)
🔑 Kapitäns-Kajüte: Admin-Bereich zum Löschen von Nachrichten, Dateien und Wiki-Seiten
🎨 Drei Designs, jederzeit umschaltbar: Klassik, Düster und Karibik
📱 Optimiert für Smartphone, Tablet und PC
🇩🇪 Oberfläche komplett auf Deutsch

Die drei Designs:

Klassik: dunkles Schiffsholz mit goldenen Akzenten und Totenkopf-Logo
Düster: Geisterschiff bei Vollmond, Sternenhimmel und Nebel über dem Wasser
Karibik: Schatzinsel mit Palmen, Sonne und Segelschiff, Inhalte auf Pergament

Unterstützte Boards

Board	Firmware-Datei	Hinweise
ESP32-S3-Zero (Waveshare)	`PirateBox_v3.1_ESP32-S3.bin`	empfohlen, klein und günstig
ESP32-S3-DevKitC (alle Varianten)	`PirateBox_v3.1_ESP32-S3.bin`	gleiche Firmware wie oben
ESP8266 D1 Mini	`PirateBox_v3.1_ESP8266.bin`	„Leichtmatrosen-Modus“ mit kleineren Grenzen, siehe unten

Voraussetzung: mindestens 4 MB Flash. Das haben alle oben genannten Boards.

Installation

Board per USB-Datenkabel an den PC anschließen. Reine Ladekabel funktionieren nicht.
Im Web Flash Tool auf dieser Seite dein Board auswählen und auf Installieren klicken. Das funktioniert in Chrome oder Edge am PC.
Den USB-Anschluss deines Boards in der Liste auswählen und warten, bis das Flashen fertig ist.
Board kurz vom Strom trennen oder die Reset-Taste drücken – fertig!

Board wird nicht erkannt? Bei ESP32-S3-Boards die BOOT-Taste gedrückt halten, kurz RESET drücken, BOOT loslassen und es noch einmal versuchen.

Erster Start

Mit dem WLAN „PirateBox“ verbinden.
Die Startseite öffnet sich automatisch. Falls nicht: im Browser http://192.168.4.1 aufrufen.
Auf 🔑 Kapitäns-Kajüte tippen und deinen eigenen Zugangscode festlegen (6–32 Zeichen).

⚠️ Wichtig: Lege den Zugangscode direkt nach dem ersten Start fest. Bis dahin könnte sich jeder im WLAN zum Kapitän machen.

Danach kannst du in der Kapitäns-Kajüte das Design wechseln, den WLAN-Namen ändern und die SD-Karte einrichten.

SD-Karte (optional)

Ohne SD-Karte landen Uploads im internen Speicher des Boards. Das sind je nach Board nur ca. 1–2 MB, genug für Textdateien und ein paar Fotos. Mit SD-Karte stehen dir Gigabytes zur Verfügung. Chat und Logbuch bleiben immer im internen Speicher.

Karte vorbereiten: microSD-Karte mit FAT32 formatieren. Karten bis 32 GB sind meist schon so formatiert.

Verkabelung ESP32-S3-Zero / ESP32-S3-DevKitC (Standard-Pins):

SD-Modul	ESP32-S3
SCK / CLK	GPIO 12
MISO / DO	GPIO 13
MOSI / DI	GPIO 11
CS / SS	GPIO 10
VCC	3V3 (Module mit Spannungsregler: 5V)
GND	GND

ESP8266 D1 Mini: Das WeMos Micro-SD-Shield einfach aufstecken. Bei einem einzelnen Modul gilt: SCK → D5, MISO → D6, MOSI → D7, CS → D8.

Andere Pins? In der Kapitäns-Kajüte unter ⚙️ Einstellungen kannst du eine Vorlage wählen oder eigene Pins eintragen. Beim ESP8266 sind SCK, MISO und MOSI fest verdrahtet, dort ist nur CS wählbar. Danach Speichern & neu starten. Ob die Karte erkannt wurde, steht direkt darunter. Uploads liegen auf der Karte im Ordner /PirateBox. Dateien, die vorher im internen Speicher lagen, werden beim ersten Start mit Karte automatisch dorthin verschoben.

Die SD-Karte wird nur beim Start erkannt. Nach dem Einstecken also einmal neu starten.

Zugangscode vergessen? – Zurücksetzen

3× kurz hintereinander die Reset-Taste drücken. Zwischen den Drücken jeweils nicht länger als 5 Sekunden warten.

Damit werden Zugangscode, WLAN-Name, SD-Pins und Design auf die Startwerte zurückgesetzt. Chat, Logbuch und Dateien bleiben erhalten. Danach kannst du in der Kapitäns-Kajüte einen neuen Zugangscode festlegen.

Grenzen

	ESP32-S3	ESP8266 D1 Mini
Geräte gleichzeitig im WLAN	8	4
Chat-Verlauf	100 Nachrichten	40 Nachrichten
Logbuch-Seiten	50 (je 8.000 Zeichen)	30 (je 4.000 Zeichen)
Interner Speicher für Uploads	ca. 1 MB	ca. 2 MB

Die PirateBox ist für kleine Gruppen gedacht. Große Dateien über WLAN zu übertragen dauert etwas, rechne mit einigen hundert KB pro Sekunde.

Häufige Fragen

Die Startseite öffnet sich nicht automatisch. Browser öffnen und http://192.168.4.1 eingeben. Auf dem iPhone ggf. im WLAN-Fenster „Ohne Internet verwenden“ wählen.

Mein Handy trennt sich immer wieder vom WLAN. Manche Smartphones wechseln automatisch in ein Netz mit Internet. Die Option „Automatisch verbinden“ für andere Netze kurz ausschalten oder „Verbunden bleiben“ bestätigen.

Die SD-Karte wird nicht erkannt. Verkabelung prüfen, Karte mit FAT32 formatieren, Pins in den Einstellungen kontrollieren und neu starten.

Kann ich die PirateBox mit Passwort betreiben? Nein, die PirateBox ist bewusst ein offenes Netz, damit jeder ohne Hürden mitmachen kann.

Sicherheit und Verantwortung

Das WLAN ist offen und unverschlüsselt. Teile darüber keine privaten oder vertraulichen Daten.
Alle Inhalte bleiben nur auf der Box. Es gibt keine Verbindung ins Internet, keine Cloud und kein Tracking.
Wer eine PirateBox betreibt, ist für die geteilten Inhalte verantwortlich. Als Kapitän kannst du unpassende Beiträge und Dateien jederzeit löschen.

Hisst die Segel – und viel Spaß beim Teilen! 🏴‍☠️