{"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\u00a0Docker<\/a>\u00a0haben wir uns die Grundlagen angesehen, wie wir mit dieser einfachen M\u00f6glichkeit professionell und ohne viel Last andere Linux-Distributionen virtualisieren.<\/p>\n\n\n\n

In diesem Beitrag der Linux Bibel sehen wir uns an, wie wir mit Docker und nur wenigen Befehlen das professionelle Wiki Wiki.js installieren. Bei Wiki.js handelt es sich um ein \u00e4u\u00dferst umfangreiches und schlankes Wiki mit vielen Funktionen und Erweiterungen.<\/p>\n\n\n\n

In diesem Beispiel haben wir Docker (nach dem ersten Link<\/em>) schon installiert, wir brauchen nur noch wenige Befehle als\u00a0Administrator am Terminal\u00a0starten.<\/p>\n\n\n\n

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

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

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

mkdir -p \/etc\/wiki<\/code><\/pre>\n\n\n\n
In diesem Verzeichnis legen wir jetzt die verschl\u00fcsselte Passwort-Datei „.db-secret<\/strong>“ an (einfach nur kopieren und einf\u00fcgen<\/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 zu arbeiten, und erstellen das Netzwerk f\u00fcr das Wiki – dies erspart uns weitere umst\u00e4ndliche Konfigurationen (einfach nur kopieren und einf\u00fcgen<\/em>):<\/p>\n\n\n\n
docker network create wikinet<\/code><\/pre>\n\n\n\n
Wir erstellen die Grundlagen f\u00fcr die Datenbank (einfach nur kopieren und einf\u00fcgen<\/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 (einfach nur kopieren und einf\u00fcgen<\/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\u00fchrt – einfach die paar Sekunden abwarten, eine Internet-Verbindung ist nat\u00fcrlich n\u00f6tig:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Jetzt erstellen wir das Wiki (einfach nur kopieren und einf\u00fcgen<\/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\u00fcr das automatische Update (einfach nur kopieren und einf\u00fcgen<\/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 \u00f6ffnen Sie den Webbrowser mit der Adresse\u00a0http:\/\/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\u00a0http:\/\/wiki.robert.org<\/a><\/em>\u00a0– 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\u00f6nnen Sie \u00fcber die Administration an die Einstellungen gehen – zuerst sollten Sie das Wiki nat\u00fcrlich auf Deutsch umstellen. Dies gelingt \u00fcber „Locale<\/em>“ bzw. „Lokalisierung<\/em>“ im Men\u00fc 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\u00dfend 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\u00fcnschte Suchmaschine f\u00fcr das Wiki l\u00e4sst sich anpassen, Standard ist einfach die Datenbank – Sie k\u00f6nnen jedoch auch etwa Elasticsearch nutzen und vieles mehr – Matomo l\u00e4sst sich per Mausklick einbinden …<\/p>\n\n\n\n
Um an die Seiten selbst zu gehen, klicken Sie rechts oben auf\u00a0Verlassen<\/strong>\u00a0und auf\u00a0Startseite erstellen<\/strong>:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Sie werden wahrscheinlich den visuellen Editor bevorzugen:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Und schon k\u00f6nnen Sie beginnen – einfach drauflostippen:<\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Ein Klick auf\u00a0Erstellen<\/strong>\u00a0erstellt 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 \u00f6ffentlichen Webserver geh\u00f6rt das Wiki nat\u00fcrlich abgesichert – nach der Einrichtung stoppen Sie das Wiki (wichtig<\/strong>\u00a0– nach der Einrichtung<\/em>):<\/p>\n\n\n\n
docker stop wiki<\/code><\/pre>\n\n\n\n
Jetzt l\u00f6schen Sie das Wiki:<\/p>\n\n\n\n
docker rm wiki<\/code><\/pre>\n\n\n\n
Anschlie\u00dfend erstellen Sie das Wiki 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