WikiJS est un système Wiki opensource, auto-hébergeable, extrêmement puissant et complet. Il possède une interface utilisateur moderne et des tonnes de paramètres, de configuration et d'options de personnalisation.
Son installation avec Docker-CE et Docker-Compose permet de mettre WikiJS en service en un rien de temps.
Aujourd'hui, nous allons passer en revue l'installation de WikiJS, ainsi que les bases de la configuration et de l'utilisation.
Ce qu'il vous faut :
- Docker-CE
- Docker-Compose
- (facultatif) Portainer-CE
- (facultatif) NGinX Proxy Manager (pour l'accès à l'url complète et SSL)
- Environ 15 minutes de votre temps.
Installation de Docker-CE, Docker-Compsoe, Portainer-CE et Nginx Proxy Manager
Walid ETTAYEB
Vous pouvez facilement installer Docker-CE, Docker-Compose, Portainer-CE et Nginx Proxy Manager en utilisant ce script d'installation rapide que j'ai créé . Il suffit d'utiliser la commande suivante :
wget https://download.ettayeb.fr/lzW3JtDjEf57TRQlR2RWOfF/01-files/scripts/portainer-nrp-docker/docker-nrp-portainer-installer.sh
chmod +x ./docker-nrp-portainer-installer.sh
./install_docker_nproxyman.sh
Lorsqu'il est exécuté, le script vous invite à sélectionner votre système d'exploitation hôte, puis vous demande quels logiciels vous souhaitez installer.
Entrez simplement 'y' pour chaque chose que vous voulez installer.
À un moment donné, votre mot de passe de super utilisateur (sudo) vous sera également demandé.
Laissez le script terminer l'installation.
Installation de Wiki-JS
Maintenant que nous avons installé Docker-CE et Docker-Compose, nous pouvons passer à l'installation et à la configuration de WikiJS. Tout d'abord, créons une structure de dossiers pour aider à garder nos applications Docker organisées et faciles à sauvegarder.
Créons un dossier " docker " qui sera le dossier de premier niveau (parent). Si vous avez déjà une structure organisationnelle pour vos installations de Docker, ne vous inquiétez pas pour cette partie.
Nous allons nous déplacer dans ce dossier de niveau parent :
mkdir docker
cd docker
Maintenant, créons un répertoire pour notre installation de WikiJS et plaçons nous dedans.
mkdir wikijs
cd wikijs
Maintenant que nous sommes dans notre dossier "wikijs", nous allons créer un fichier appelé "docker-compose.yml".
touch docker-compose.yml
Nous devons copier le bloc de code yaml suivant, et le coller dans le fichier "docker-compose.yml" que nous avons crée précédement:
version: "3"
services:
wikijs:
image: lscr.io/linuxserver/wikijs
container_name: wikijs
environment:
- PUID=1000
- PGID=1000
- TZ=Europe/Paris
volumes:
- ./config:/config
- ./data:/data
ports:
- 3000:3000
restart: unless-stopped
Dans le fichier, vous remarquerez quelques endroits où vous voudrez peut-être apporter des modifications.
Tout d'abord, regardons le mappage du port. 3000 est un port très courant pour de nombreuses applications, c'est donc généralement une bonne idée de le changer pour un autre port sur votre machine hôte. La machine "hôte" est le système physique sur lequel vous placez l'application dockerisée. Le "conteneur" est l'espace d'application où l'application s'exécute (séparé / sandboxé loin du système d'exploitation physique). Les mappages de port et de volume sont configurés comme suit :
<host>:<container>
Vous pouvez donc modifier le mappage de volume ou de port du côté hôte dans le fichier docker-compose.yml. Mais ne modifiez pas le côté conteneur, sauf si vous êtes un développeur et que vous savez ce que vous faites.
Pour ma configuration, j'ai utilisé le port 9190 au lieu du port 3000, donc mon mappage de port ressemble à ceci :
ports:
- 9190:3000
Maintenant, nous sommes prêts à exécuter le fichier docker-compose, à extraire l'image WikiJS et à démarrer le conteneur.
Il suffit d'entrer :
docker-compose up -d
Lorsque le conteneur a fini de démarrer, vous devriez voir done dans le terminal. Vérifiez que vous ne voyez pas d'erreurs dans la sortie du terminal.
Si tout s'est bien passé, vous devriez maintenant être en mesure d'utiliser un navigateur web pour aller sur l'IP de votre machine hôte et le port que vous avez entré dans le fichier docker-compose.yml, et accédé à l'assistant de première exécution de WikiJS.
Consultez l'article ci-dessous pour obtenir des détails sur la configuration sur la façon de configurer votre Wiki avec un FQDN (Fully Qualified Domain Name) et un certificat SSL LetsEntcrypt.
Walid ETTAYEB