Allgemein
Was ist BookStax?
BookStax ist eine native iOS-App, mit der du direkt vom iPhone oder iPad auf deine selbst gehostete BookStack-Instanz zugreifen und sie verwalten kannst. Die App bietet eine übersichtliche, für mobile Geräte optimierte Oberfläche zum Lesen, Erstellen und Bearbeiten deiner Dokumentation – wo auch immer du bist.
Brauche ich einen BookStack-Account, um BookStax zu nutzen?
Ja. BookStax verbindet sich mit einer bestehenden, selbst gehosteten BookStack-Instanz. Du benötigst einen laufenden BookStack-Server sowie gültige Zugangsdaten (oder einen API-Token). BookStax stellt keinen BookStack-Server für dich bereit.
Ist BookStax kostenlos?
BookStax ist im App Store erhältlich. Den aktuellen Preis findest du direkt im App Store. Es gibt kein Abo – BookStax ist ein einmaliger Kauf.
Welche Plattformen unterstützt BookStax?
BookStax ist eine native SwiftUI-App für iOS und iPadOS. Voraussetzung ist ein iPhone oder iPad mit iOS 16 oder neuer. Eine macOS-Version (via Mac Catalyst) ist derzeit nicht verfügbar.
Einrichtung & Verbindung
Wie verbinde ich BookStax mit meinem BookStack-Server?
Beim ersten Start wirst du aufgefordert, die URL deines BookStack-Servers einzugeben (z. B. https://bookstack.meinedomain.de) sowie deine API-Token-ID und das Token-Secret. Diese kannst du in deinem BookStack-Benutzerprofil unter API-Tokens erstellen.
Wo finde ich meinen BookStack API-Token?
Melde dich in deiner BookStack-Instanz an, klicke oben rechts auf dein Profilbild, gehe zu Profil bearbeiten und scrolle nach unten zum Abschnitt API-Tokens. Erstelle dort einen neuen Token – BookStax benötigt sowohl die Token-ID als auch das Token-Secret. Bewahre das Secret sicher auf, da es danach nicht mehr angezeigt wird.
Kann ich mehrere BookStack-Instanzen verbinden?
Ja. BookStax unterstützt mehrere Server-Profile. Du kannst in den App-Einstellungen verschiedene BookStack-Instanzen hinzufügen und zwischen ihnen wechseln.
Mein Server verwendet ein selbstsigniertes Zertifikat. Funktioniert BookStax trotzdem?
BookStax benötigt eine gültige HTTPS-Verbindung zum BookStack-Server. Selbstsignierte Zertifikate werden von iOS standardmäßig nicht vertraut. Wir empfehlen die Nutzung eines ordentlichen TLS-Zertifikats – kostenlose Optionen wie Let’s Encrypt funktionieren einwandfrei. Wenn dein Server hinter einem Reverse Proxy (z. B. Caddy oder Nginx) läuft, wird die TLS-Terminierung in der Regel dort erledigt.
Kann ich BookStax mit einem lokal gehosteten BookStack nutzen (ohne öffentliche Domain)?
Ja, solange dein iOS-Gerät den Server erreichen kann. Das funktioniert im gleichen lokalen Netzwerk (z. B. Heim-WLAN) oder per VPN von unterwegs. Eine gültige HTTPS-Verbindung ist dennoch erforderlich – du kannst dafür ein lokales DNS-Override und ein Wildcard- oder Domain-Zertifikat verwenden.
Ich bekomme einen Verbindungsfehler / 403 Forbidden. Was soll ich prüfen?
- Stelle sicher, dass die Server-URL keinen abschließenden Schrägstrich enthält.
- Überprüfe, ob Token-ID und Token-Secret korrekt eingegeben wurden.
- Stelle sicher, dass dein Reverse Proxy den
Authorization-Header an BookStack weiterleitet (manche Proxys entfernen diesen standardmäßig). - Prüfe, ob die BookStack-API in den Instanz-Einstellungen aktiviert ist (Einstellungen → API).
- Falls du Bot-Schutz einsetzt (z. B. Anubis oder Cloudflare), stelle sicher, dass der Pfad
/api/für API-Clients nicht gesperrt ist.
Funktionen
Was kann ich mit BookStax machen?
Mit BookStax kannst du:
- Deine BookStack-Regale, Bücher, Kapitel und Seiten durchsuchen
- Seiteninhalte in einem übersichtlichen, lesefreundlichen Layout lesen
- Seiten direkt auf deinem Gerät erstellen und bearbeiten
- Die gesamte BookStack-Bibliothek durchsuchen
- Zuletzt aufgerufene Inhalte schnell wiederfinden
- Inhalte auch offline lesen (gecachte Seiten)
Unterstützt BookStax Offline-Lesen?
Ja. Seiten, die du bereits geöffnet hast, werden lokal auf deinem Gerät mit SwiftData gecacht. So kannst du sie auch ohne aktive Serververbindung lesen. Änderungen, die du offline vorgenommen hast, werden beim nächsten Verbindungsaufbau synchronisiert.
Kann ich Seiten in BookStax erstellen und bearbeiten?
Ja. BookStax enthält einen Editor zum Erstellen neuer Seiten und Bearbeiten bestehender. Du kannst Inhalte in Markdown schreiben – diese werden dann über die API in deiner BookStack-Instanz gespeichert.
Unterstützt BookStax Anhänge und Bilder auf Seiten?
Bilder, die in Seiten eingebettet sind, werden beim Lesen inline dargestellt. Das Hochladen neuer Bilder oder die Verwaltung von Anhängen direkt in der App ist für eine zukünftige Version geplant.
Gibt es eine Suchfunktion?
Ja. BookStax nutzt die BookStack-Such-API, um eine Volltextsuche über alle Regale, Bücher, Kapitel und Seiten deiner Instanz zu ermöglichen. Ergebnisse werden mit Kontext angezeigt, damit du schnell das Gesuchte findest.
Unterstützt BookStax den Dark Mode?
Ja. BookStax unterstützt den iOS Dark Mode vollständig und folgt automatisch der Systemeinstellung. In den App-Einstellungen kannst du das Erscheinungsbild bei Bedarf auch manuell festlegen.
Datenschutz & Sicherheit
Sammelt BookStax Daten?
Nein. BookStax erfasst, überträgt oder teilt keinerlei persönliche Daten. Die gesamte Kommunikation findet ausschließlich zwischen deinem Gerät und deinem eigenen BookStack-Server statt. Deine API-Zugangsdaten werden sicher im iOS Keychain gespeichert.
Wo werden meine Zugangsdaten gespeichert?
Deine API-Token-ID und das Token-Secret werden im iOS Keychain gespeichert – demselben sicheren Speicherbereich, den iOS selbst für Passwörter und Authentifizierungsdaten nutzt. Sie werden niemals im Klartext gespeichert oder an Dritte übertragen.
Verwendet BookStax Analyse- oder Tracking-SDKs von Drittanbietern?
Nein. BookStax enthält keine Analyse-, Werbe- oder Tracking-Bibliotheken von Drittanbietern. Die App hat außer den Standard-Apple-Frameworks keine externen Abhängigkeiten.
Problemlösung
Die App zeigt „Verbindung zum Server nicht möglich“. Was kann ich tun?
Prüfe zunächst, ob deine BookStack-Instanz im Browser auf demselben Gerät erreichbar ist. Dann überprüfe:
- Die Server-URL in BookStax stimmt mit der im Browser verwendeten Adresse überein (inklusive
https://). - Dein Gerät hat eine aktive Internetverbindung oder ist im richtigen lokalen Netzwerk.
- Keine Firewall oder VPN blockiert den Zugriff.
- Falls du einen Reverse Proxy verwendest, leitet dieser API-Anfragen korrekt weiter.
Seiten laden im Browser, aber nicht in BookStax. Woran liegt das?
Das deutet meist darauf hin, dass die API deaktiviert oder gesperrt ist. Prüfe, ob die BookStack-API in den Admin-Einstellungen aktiviert ist und dass dein Reverse Proxy Anfragen an die Pfade /api/docs und /api/v1/ nicht blockiert oder verändert.
Wie kann ich meine Serververbindung zurücksetzen?
Gehe in BookStax zu Einstellungen → Server, wähle deinen Server aus und tippe auf Bearbeiten oder Entfernen. Anschließend kannst du deine Zugangsdaten neu eingeben oder ein komplett neues Server-Profil anlegen.
Ich habe einen Fehler gefunden. Wie melde ich ihn?
Bitte nutze das Support-Formular oder schreibe eine E-Mail an die im App Store angegebene Adresse. Gib dabei deine iOS-Version, die BookStax-Version und eine kurze Beschreibung des Problems an. Screenshots oder Bildschirmaufnahmen helfen uns sehr bei der Fehleranalyse.
Updates & Roadmap
Wie oft wird BookStax aktualisiert?
Updates werden veröffentlicht, sobald neue Funktionen fertig sind oder Fehler behoben wurden. Aktiviere automatische Updates in den App Store-Einstellungen, um immer auf dem neuesten Stand zu sein.
Kann ich eine Funktion vorschlagen?
Sehr gerne! Feature-Wünsche sind willkommen – nutze dazu das Support-Formular oder melde dich über den App Store. Die am häufigsten gewünschten Funktionen werden priorisiert und für zukünftige Versionen eingeplant.
Ist eine Android-Version geplant?
BookStax ist derzeit eine reine iOS/iPadOS-App, entwickelt mit SwiftUI – einer Apple-exklusiven Technologie. Eine Android-Version ist aktuell nicht geplant.
Mehr Hintergründe zur App findest du auf der Startseite. Versionshinweise gibt es im BookStax-Bereich. Direkter Kontakt über das Support-Formular.