Wie man HedgeDoc bei Saplo installiert (gemeinsames Bearbeiten von Markdown-Dokumenten in Echtzeit)

Notizen von einem Meeting allein zu machen, während der Rest des Teams wartet oder Kommentare in den Chat tippt, ist langsamer als gemeinsam live am selben Dokument zu arbeiten. Notion und Dropbox Paper können das, aber zum Preis eines Kontos in einer fremden Cloud und eines Abonnements, das mit der Anzahl der Teammitglieder steigt. HedgeDoc ist ein Open-Source-Markdown-Editor, mit dem mehrere Personen gleichzeitig am selben Dokument arbeiten, die Cursor und Änderungen der anderen in Echtzeit sehen und das Ganze auf deiner eigenen Box hosten können. Im Folgenden erfährst du Schritt für Schritt, wie du HedgeDoc auf Saplo installierst.

Warum HedgeDoc statt Notion oder Dropbox Paper

Kostenpflichtige Tools zur gemeinsamen Dokumentenbearbeitung haben zwei Eigenschaften, die kleinen Teams und Freelancern am meisten zu schaffen machen:

• Der Preis steigt mit der Anzahl der Personen - Der kostenlose Plan reicht in der Regel für eine Person aus, aber das Hinzufügen jedes weiteren Mitarbeiters zum Team in Notion oder einem ähnlichen Tool ist jeden Monat ein separater Posten auf der Rechnung.
• Der Inhalt der Dokumente liegt auf fremden Servern - Besprechungsnotizen, Projektpläne und Textentwürfe befinden sich in den Händen einer externen Firma, nicht bei dir.

HedgeDoc läuft als Docker-Container mit einem eigenen PostgreSQL-Container auf deiner Box, sodass der Inhalt aller Dokumente und die Bearbeitungshistorie auf deiner Infrastruktur bleiben, ohne Gebühr pro Person und ohne Limit für die Anzahl der Dokumente.

HedgeDoc, Trilium und Wiki.js/BookStack: Drei verschiedene Nischen für Notizen im Saplo Katalog

Da Trilium Notes sowie Wiki.js und BookStack bereits im Saplo Katalog verfügbar sind, stellt sich natürlich die Frage, was HedgeDoc von diesen unterscheidet. Die Antwort liegt in dem, wofür jedes dieser Tools gedacht ist:

• Trilium Notes ist ein Notizbuch für eine Person - eine hierarchische Notiz- und Wissensdatenbank, die von einem einzelnen Benutzer über einen längeren Zeitraum aufgebaut wird, ohne den Fokus auf Live-Bearbeitung durch mehrere Personen gleichzeitig.
• Wiki.js und BookStack sind Unternehmens-Wikis mit Seitenversionierung, Kategorienstruktur und Berechtigungen - gut für Dokumentationen, die eine feste Struktur und Änderungsverlauf haben, aber nicht für schnelle, gemeinsame Live-Entwürfe.
• HedgeDoc konzentriert sich ausschließlich auf die Live- und gleichzeitige Bearbeitung eines einzelnen Markdown-Dokuments - du siehst die Cursor anderer Teilnehmer und deren Änderungen in Echtzeit, ohne die Struktur einer gesamten Wissensdatenbank und ohne ein Berechtigungssystem wie in einem Unternehmens-Wiki.

Wenn du eine persönliche Wissensdatenbank aufbaust, sieh dir Trilium an. Wenn dein Team eine strukturierte Dokumentation mit Versionsverlauf benötigt, wähle Wiki.js oder BookStack. Wenn es um das gemeinsame Schreiben von Besprechungsnotizen oder das Entwerfen eines Textes live, hier und jetzt, zusammen mit jemandem geht, passt HedgeDoc am besten.

Anforderungen

Um HedgeDoc bei Saplo zu hosten, benötigst du:

• Eine Box mit laufendem Docker (die Engine startet es automatisch bei der Installation aus dem Katalog, Container-Nesting ist erforderlich, was Saplo standardmäßig bietet),
• mindestens 1 GB freien RAM auf der Box und 2 GB Speicherplatz, d.h. den Tarif Box M (65 €/Jahr) oder höher,
• eine Domain oder Subdomain *.saploapp.pl, die in jedem Tarif enthalten ist und unter der der Editor laufen wird,
• eine separate Datenbank musst du NICHT manuell einrichten - HedgeDoc benötigt eine SQL-Datenbank, und die Engine stellt dafür einen dedizierten PostgreSQL-Container in derselben docker-compose bereit (die gemeinsam genutzte Saplo-Datenbank unterstützt nur MySQL/MariaDB).

Schritt-für-Schritt-Anleitung zur Installation

1. Gehe im Saplo-Panel zum App-Katalog und wähle HedgeDoc (Kategorie "Business").
2. Wähle eine Box mit mindestens 1 GB freiem RAM, auf der der Editor installiert werden soll, und eine Domain oder Subdomain, unter der er betrieben wird.
3. Bestätige die Installation. Die Engine stellt einen Container aus dem offiziellen Image quay.io/hedgedoc/hedgedoc zusammen mit einem dedizierten postgres:15-alpine-Container bereit, generiert ein zufälliges Datenbankpasswort und einen zufälligen Session-Secret, und stellt dann die Anwendung ausschließlich auf dem Loopback der Box zur Verfügung, die an nginx angeschlossen ist. Dieser liefert die Anwendung unter der angegebenen Domain mit kostenlosem SSL aus. Nach außen ist nur Port 443 freigegeben, nicht der rohe Port des Containers.
4. Nach docker compose up prüft die Engine zusätzlich, ob die HedgeDoc-Seite tatsächlich per HTTP antwortet, da der erste Start des Containers Datenbank-Schema-Migrationen durchführt und länger als die üblichen paar Sekunden dauern kann. Der Status "Container läuft" bedeutet also noch nicht, dass die Anwendung bereit ist.
5. Die gemeinsame Bearbeitung funktioniert über Websockets auf derselben Domain wie die Anwendung - sie erfordert keine zusätzliche Client-seitige Konfiguration oder einen separaten Port.

Erste Konfiguration

HedgeDoc hat, im Gegensatz zu Directus oder Wiki.js, kein Administrator-Konto. Jeder, der sich registriert, ist ein normaler Benutzer und sieht nur seine eigenen Dokumente und diejenigen, zu denen er einen Link erhalten hat.

1. Gehe zur Domain-Adresse, zum Beispiel notatki.saploapp.pl, und erstelle das erste Konto im Registrierungsassistenten, wenn du die Seite zum ersten Mal besuchst.
2. Erstelle ein neues Dokument mit der Schaltfläche New note - du erhältst einen einzigartigen Bearbeitungslink, den du an jeden sendest, der an der gemeinsamen Arbeit am Inhalt teilnehmen soll.
3. Mitarbeiter öffnen denselben Link und sehen sofort die Cursor und Änderungen anderer in Echtzeit, ohne ein eigenes Konto erstellen zu müssen, wenn das Dokument einen offenen Bearbeitungszugang hat.
4. Das fertige Dokument exportierst du aus dem Dokumentmenü als PDF, HTML oder Roh-Markdown-Datei, oder du teilst es über einen separaten Link schreibgeschützt.
5. Die Versionshistorie des Dokuments kannst du in der Ansicht Revision einsehen, was es dir ermöglicht, zu früheren Inhalten zurückzukehren, ohne manuelle Backups kopieren zu müssen.

HedgeDoc auf Saplo vs. Notion und Dropbox Paper

Häufig gestellte Fragen

Benötigt HedgeDoc eine separate Datenbank? Ja, im Gegensatz zu einigen Anwendungen im Saplo-Katalog benötigt HedgeDoc eine SQL-Datenbank. Daher stellt die Engine einen dedizierten PostgreSQL-Container im selben docker-compose zur Verfügung und verwendet nicht die gemeinsam genutzte Saplo-Datenbank, die nur für MySQL/MariaDB verfügbar ist.

Was ist der Unterschied zwischen HedgeDoc und Trilium Notes, da beide im Saplo-Katalog sind? Trilium ist ein hierarchischer Notizblock für eine Person, der über einen längeren Zeitraum aufgebaut wird. HedgeDoc konzentriert sich auf die gleichzeitige Live-Bearbeitung eines einzelnen Dokuments durch mehrere Personen.

Muss man ein Konto erstellen, um ein Dokument gemeinsam zu bearbeiten? Nein, wenn das Dokument offenen Bearbeitungszugriff hat, reicht ein Link aus. Du erstellst ein Konto nur, um eine dauerhaft gespeicherte Liste deiner eigenen Dokumente zu haben.

Kann man ein fertiges Dokument aus HedgeDoc exportieren? Ja, über das Dokumentenmenü kannst du den Inhalt als PDF, HTML oder Roh-Markdown-Datei exportieren.

Wenn dein Team Notizen und Entwürfe gemeinsam und live erstellt und dafür einen einfachen Editor ohne Pro-Nutzer-Abonnement sucht, schreib uns. Wir helfen dir gerne, die richtige Box für dein Team auszuwählen.