- Das Titelbild stammt von der offiziellen Webseite joplinapp.org/de. Alles weiteren Screenshots in diesem Tutorial stammen aus meiner eigenen Testumgebung. Der gesamte Text wurde eigenständig verfasst. Codepassagen und Ideen stammen z.T. von der offiziellen GitHub Seite github.com/laurent22/joplin/bl…docker-compose.server.yml.
- Yes
Liebe Forengemeinde,
in diesem Tutorial stelle ich Euch eine Anleitung zur Verfügung, mit welcher Ihr Joplin auf Eurem NAS installieren könnt. Voraussetzung für dieses Tutorial ist Portainer, Nginx sowie eine eigene Domain.
Please log in or register for free to view graphics and attachments.
Vorbereitungsarbeiten - Ermitteln von PUID und PGID:
- siehe hierzu bei Bedarf [TUT] SSH Verbindung auf ein UGREEN NAS herstellen
1. Consolenfenster öffnen und per ssh auf Euer NAS verbinden (SHH muss natürlich aktiviert sein).
2. Als Admin anmelden.
3. Folgende Befehle ausführen: id -u (gibt die PUID zurück, im Beispiel 1000) und id -g (gibt die PGID zurück, im Beispiel 10).
4. PUID und PGID notieren, diese Werte brauchen wir gleich.
Installationsanleitung:
1. Dateimanager öffnen.
2. In den Ordner "docker" wechseln.
3. Erstellen des Ordners "joplin".
Please log in or register for free to view graphics and attachments.
4. Die Datei "joplin.zip" herunterladen, entpacken und die Datei joplin.yaml in einem Texteditor deiner Wahl öffnen.
5. PUID und PGID unter "user" anpassen (Angabe mit PUID:PGID).
6. Volume-Pfad unter "volumes" anpassen.
7. Portainer öffnen und einloggen (http://nas-ip:9443, z.B. http://192.168.178.146:9443).
8. "Live Connect" anklicken.
Please log in or register for free to view graphics and attachments.
9. Im linken Menü auf den Punkt "Stacks" klicken und danach rechts auf "+ Add Stack".
Please log in or register for free to view graphics and attachments.
10. Unter "Name" nun joplin (oder einen alternativen Namen) eingeben.
11. Nun den gesamten Inhalt der Datei joplin.yaml kopieren und in den darunterliegenden "Web editor" einfügen.
12. Schließen der Datei joplin.yaml.
13. Die Datei stack.env aus dem extrahierten Ordner von "joplin.zip" in einem Texteditor deiner Wahl öffnen.
14. Alle Parameter nach deinen Gegebenheiten editieren und anschließend speichern.
Please log in or register for free to view graphics and attachments.
15. Nach unten scrollen und auf "Load variables from .env file" klicken.
Please log in or register for free to view graphics and attachments.
16. Nun zum Speicherpfad der Datei stack.env navigieren, diese auswählen und auf "Öffnen" klicken.
Please log in or register for free to view graphics and attachments.
17. Alle Variablen werden nun geladen, dies dauert nur eine Sekunde
18. Anschließend etwasnach unten scrollen und auf "Deploy the stack" klicken.
Please log in or register for free to view graphics and attachments.
19. Das Image wird und heruntergeladen und mit allen angegebenen Parametern installiert, dies dauert ein paar Minuten.
20. Klicke im linken Menü auf "Container", es sollten nun der Conatiner "joplin_app" mit dem Status "running" sowie der Container "joplin_db" mit dem Status "healthy" sichtbar sein.
Please log in or register for free to view graphics and attachments.
21. Fertig.
Konfiguration der Domain in Nginx:
Die nachfolgenden Schritte setzen voraus, dass du Nginx bereits installiert und Zertifikat eingerichtet hast.
1. Proxy Host hinzufügen.
Please log in or register for free to view graphics and attachments.
2. Unter dem Reiter "Details" folgendes durchführen:
a. Deinen Domain-Namen angeben (1).
b. Das Schema "http" aus dem Dropdown auswählen (2).
c. Den "Forward Hostname / IP" = IP-Adresse des NAS angeben (3).
d. Den Port der in unserer joplin.yaml definiert wurde = 22300 angeben (4).
e. Bei "Websockets Support" Den Schalter an machen (5).
Please log in or register for free to view graphics and attachments.
3. Unter dem Reiter "SSL" folgendes durchführen:
a. Dein SSL-Zertifikat im Dropdown auswählen (6).
b. Den Schalter "Erzwinge SSL" an machen (7).
c. Den Schalter "HSTS aktiviert" an machen (8).
d. Den Schalter "HTTP/2 Support" an machen (9).
e. Anschließend auf "Speichern" klicken.
This image is exclusive to our members!
Please log in or register for free to view graphics and attachments.
Erster Einstieg in Joplin:
1. Den Browser deiner Wahl öffnen.
2. https://deinedomain.tld eingeben (z.B. https://joplin.ugreen-forum.de).
3. Default-Login (Email: admin@localhost, Password: admin) eingeben und auf "Login" klicken.
Please log in or register for free to view graphics and attachments.
4. Passwort für den Admin-User über "Change it now" ändern und auf "Update now" klicken.
Please log in or register for free to view graphics and attachments.
5. Anschließend über den Tab "Admin" (1), Memnü "Users" (2) und "Add user" (3) einen neuen User anlegen.
Please log in or register for free to view graphics and attachments.
Please log in or register for free to view graphics and attachments.
6. Du erhältst nun eine E-Mail mit einem Link, über welchen der Account aktiviert werden muss, klicke auf "Complete your Account".
Please log in or register for free to view graphics and attachments.
7. Fertig - nun kannst du dir die Apps von der offiziellen Webseite Installation | Joplin für alle Plattformen herunterladen und auf deinen Endgeräten installieren.
Verbinden der Desktop-App mit deinem Joplin-Server:
1. Joplin öffnen.
2. Klick auf "Werkzeuge" (1) und dann auf "Optionen" (2).
Please log in or register for free to view graphics and attachments.
3. Klick auf "Synchronisation" (3).
4. Auswahl von "Joplin Server" aus dem Dropdown-Menü (4).
5. Deine in Nginx konfigurierte Domain/Subdomain angeben (5).
6. Die E-Mail-Adresse des angelegten Users angeben (6).
7. Das Passwort des Users angeben (7).
8. Klick auf "Synchronisationskonfiguration prüfen (8).
Please log in or register for free to view graphics and attachments.
9. Wenn diese Erfolgsmeldung erscheint, wurde die Einrichtung erfolgreich abgeschlossen und du bist einsatzbereit.
Please log in or register for free to view graphics and attachments.
Bei den mobilen Apps ist die Einrichtung ähnlich, diese sollte soweit selbsterklärend sein.
Download:
Weiterführende Links:
Viel Spaß beim installieren!