{"id":2552,"date":"2023-09-10T12:47:11","date_gmt":"2023-09-10T10:47:11","guid":{"rendered":"https:\/\/linux-bibel.at\/?p=2552"},"modified":"2023-09-10T12:47:14","modified_gmt":"2023-09-10T10:47:14","slug":"wiki-js-professionelles-wiki-mit-docker-unter-linux","status":"publish","type":"post","link":"https:\/\/linux-bibel.at\/index.php\/2023\/09\/10\/wiki-js-professionelles-wiki-mit-docker-unter-linux\/","title":{"rendered":"Wiki.js – Professionelles Wiki mit Docker unter Linux"},"content":{"rendered":"\n

Unter Docker<\/a> haben wir uns die Grundlagen angesehen, wie wir mit dieser einfachen Möglichkeit professionell und ohne viel Last andere Linux<\/a>-Distribution<\/a>en virtualisieren.<\/p>\n\n\n\n

In diesem Beitrag der Linux<\/a> Bibel sehen wir uns an, wie wir mit Docker<\/a> und nur wenigen Befehl<\/a>en das professionelle Wiki<\/a> Wiki<\/a>.js installieren. Bei Wiki<\/a>.js handelt es sich um ein äußerst umfangreiches und schlan<\/a>kes Wiki<\/a> mit vielen Funktionen und Erweiterungen.<\/p>\n\n\n\n

In diesem Beispiel haben wir Docker<\/a> (nach dem ersten Link<\/em>) schon installiert, wir brauchen nur noch wenige Befehl<\/a>e als Administrator<\/a> am Terminal<\/a> starten.<\/p>\n\n\n\n

Wiki.js installieren<\/h3>\n\n\n\n

Wiki<\/a>.js benötigt nur wenig Platz, auch das Docker<\/a>-Image – also das virtualisierte System hat nur wenige MB. Zum Funktionieren benötigt Wiki<\/a>.js eine Datenbank<\/a> – hierzu nutzen wir PostgreSQL – viel schlan<\/a>ker als MariaDB<\/a> – rund 300 MB. Ein Drittes Image dient dazu, Wiki<\/a>.js automatisch zu aktualisieren.<\/p>\n\n\n\n

Zuerst erstellen wir auf dem realen System das Verzeichnis<\/a> „wiki<\/a><\/em>“ im System-Verzeichnis<\/a> „\/etc<\/em>“ (einfach nur kopieren und einfügen<\/em>):<\/p>\n\n\n\n

mkdir -p \/etc\/wiki<\/code><\/pre>\n\n\n\n
In diesem Verzeichnis<\/a> legen wir jetzt die verschlüsselte Passwort-Datei<\/a> „.db-secret<\/strong>“ an (einfach nur kopieren und einfügen<\/em>):<\/p>\n\n\n\n
openssl rand -base64 32 > \/etc\/wiki\/.db-secret<\/code><\/pre>\n\n\n\n
Jetzt beginnen wir, mit Docker<\/a> zu arbeiten, und erstellen das Netzwerk<\/a> für das Wiki<\/a> – dies erspart uns weitere umständliche Konfiguration<\/a>en (einfach nur kopieren und einfügen<\/em>):<\/p>\n\n\n\n
docker network create wikinet<\/code><\/pre>\n\n\n\n
Wir erstellen die Grundlagen für die Datenbank<\/a> (einfach nur kopieren und einfügen<\/em>):<\/p>\n\n\n\n
docker volume create pgdata<\/code><\/pre>\n\n\n\n
Weiter geht es mit dem Erstellen der Images – wir beginnen mit dem Image der Datenbank<\/a> (einfach nur kopieren und einfügen<\/em>):<\/p>\n\n\n\n
docker create --name=db -e POSTGRES_DB=wiki -e POSTGRES_USER=wiki -e POSTGRES_PASSWORD_FILE=\/etc\/wiki\/.db-secret -v \/etc\/wiki\/.db-secret:\/etc\/wiki\/.db-secret:ro -v pgdata:\/var\/lib\/postgresql\/data --restart=unless-stopped -h db --network=wikinet postgres:11<\/code><\/pre>\n\n\n\n
Hierbei werden alle Aufgaben automatisch ausgeführt – einfach die paar Sekunden abwarten, eine Internet-Verbindung ist natürlich nötig:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Jetzt erstellen wir das Wiki<\/a> (einfach nur kopieren und einfügen<\/em>):<\/p>\n\n\n\n
docker create --name=wiki -e DB_TYPE=postgres -e DB_HOST=db -e DB_PORT=5432 -e DB_PASS_FILE=\/etc\/wiki\/.db-secret -v \/etc\/wiki\/.db-secret:\/etc\/wiki\/.db-secret:ro -e DB_USER=wiki -e DB_NAME=wiki -e UPGRADE_COMPANION=1 --restart=unless-stopped -h wiki --network=wikinet -p 80:3000 -p 443:3443 ghcr.io\/requarks\/wiki:2<\/code><\/pre>\n\n\n\n
Wir erstellen das Image für das automatische Update<\/a> (einfach nur kopieren und einfügen<\/em>):<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Wir starten die drei Images:<\/p>\n\n\n\n
docker start db\ndocker start wiki\ndocker start wiki-update-companion<\/code><\/pre>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Jetzt öffnen Sie den Webbrowser mit der Adresse http:\/\/localhost\/<\/a><\/em>:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Geben Sie Ihre E-Mail-Adresse an, legen ein Passwort fest und geben die URL an – in meinem Beispiel einfach http:\/\/wiki.robert.org<\/a><\/em> – nach wenigen Sekunden ist die Software installiert:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Sie melden sich mit Ihrem vergebenen Passwort und Ihrer Mail-Adresse an:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Und schon können Sie über die Administration an die Einstellungen gehen – zuerst sollten Sie das Wiki<\/a> natürlich auf Deutsch umstellen. Dies gelingt über „Locale<\/em>“ bzw. „Lokalisierung<\/em>“ im Menü links:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Dazu klicken Sie rechts bei „German<\/em>“ auf das Icon mit der Wolke (= Download bzw. Herunterladen) und stellen anschließend oben links die Sprache um, ein Klick rechts oben auf Apply<\/strong> und schon ist es geschehen.<\/p>\n\n\n\n
Die restlichen Einstellungen kommen auf Ihren Geschmack an – die gewünschte Suchmaschine für das Wiki<\/a> lässt sich anpassen, Standard ist einfach die Datenbank<\/a> – Sie können jedoch auch etwa Elasticsearch nutzen und vieles mehr – Matomo lässt sich per Mausklick einbinden …<\/p>\n\n\n\n
Um an die Seiten selbst zu gehen, klicken Sie rechts oben auf Verlassen<\/strong> und auf Startseite erstellen<\/strong>:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Sie werden wahrscheinlich den visuellen Editor<\/a> bevorzugen:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Und schon können Sie beginnen – einfach drauflostippen:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Ein Klick auf Erstellen<\/strong> erstellt die Startseite, rechts oben erstellen Sie Unterseiten:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Wiki.js per HTTPS absichern<\/h3>\n\n\n\n
Auf einem öffentlichen Webserver<\/a> gehört das Wiki<\/a> natürlich abgesichert – nach der Einrichtung stoppen Sie das Wiki<\/a> (wichtig<\/strong> – nach der Einrichtung<\/em>):<\/p>\n\n\n\n
docker stop wiki<\/code><\/pre>\n\n\n\n
Jetzt löschen Sie das Wiki<\/a>:<\/p>\n\n\n\n
docker rm wiki<\/code><\/pre>\n\n\n\n
Anschließend erstellen Sie das Wiki<\/a> mit HTTPS per Letsencrypt:<\/p>\n\n\n\n
docker create --name=wiki -e LETSENCRYPT_DOMAIN=wiki.example.com -e LETSENCRYPT_EMAIL=admin@example.com -e SSL_ACTIVE=1 -e DB_TYPE=postgres -e DB_HOST=db -e DB_PORT=5432 -e DB_PASS_FILE=\/etc\/wiki\/.db-secret -v \/etc\/wiki\/.db-secret:\/etc\/wiki\/.db-secret:ro -e DB_USER=wiki -e DB_NAME=wiki -e UPGRADE_COMPANION=1 --restart=unless-stopped -h wiki --network=wikinet -p 80:3000 -p 443:3443 ghcr.io\/requarks\/wiki:2<\/code><\/pre>\n\n\n\n