Cette procédure a été conçue pour une distribution Linux basée sur Debian/Ubuntu
¶ Prérequis
- NodeJS (Minimum version 12.10)
- PostgreSQL (MySQL/MariaDB partiellement supporté)
¶ Installer NodeJS
- Ajouter le dépôt
sudo apt -y install curl dirmngr apt-transport-https lsb-release ca-certificates
curl -sL https://deb.nodesource.com/setup_12.x | sudo -E bash -
- Installer le paquet :
sudo apt update && sudo apt install nodejs
¶ Installer et configurer PostgreSQL
- Installer le paquet :
sudo apt install postgresql - Modifier le fichier pg_hba.conf :
sudo nano /etc/postgresql/10/pg_hba.conf
# Modifier la ligne :
local all all peer
# Par
local all all md5
- Redémarrer le service :
sudo service postgresql restart
Vérifier que le service est démarré avec
sudo service postgresql status
- Créer un utilisateur pour wikijs
#1 : Se connecter en tant que postgres
sudo -i -u postgres
#2 : Créer un utilisateur
createuser -P --interactive wikijs
#3 : Créer la base de données (Pour des raisons de simplicité, la nommer avec le même nom que l'utilisateur)
createdb wikijs
#4 : Se connecter à la base de données
psql -U wikijs
#5 : Quitter la base de données
\quit
#6 : Quitter le compte postgres
exit
¶ Installer WikiJS
- Se rendre dans le répertoire TMP :
cd /tmp - Télécharger l'archive de WikiJS :
wget https://github.com/Requarks/wiki/releases/download/2.4.107/wiki-js.tar.gz - Créer le répertoire wikijs :
sudo mkdir /etc/wikijs - Extraire le contenu de l'archive dans ce répertoire :
tar xzf wiki-js.tar.gz -C /etc/wikijs - Se rendre dans ce répertoire :
cd /etc/wikijs
¶ Configuration
- Renommer le fichier de configuration d'exemple :
mv config.sample.yml config.yml - Editer le fichier :
nano config.yml
# Choisir le port
port : 3000
#Configurer la base de données
db:
type: postgres
host: localhost
port: 5432
user: wikijs
pass: wikijs
db: wikijs
- Fermer le fichier et lancer le serveur :
sudo node server - Lancer un navigateur vers l'adresse indiquée (remplacer localhost par son adresse IP)
Important : Il faut impérativement mettre l'URL par laquelle sera atteint le site. Si c'est une adresse IP, alors il faut mettre l'IP et le port.
- Se connecter, puis accéder à l'URL http://ip_wiki/a pour accéder à l'interface d'administration.
¶ Configurer WikiJS comme un service
- Créer le fichier
/etc/systemd/system/wiki.service - Le remplir comme ceci :
[Unit]
Description=Wiki.js
After=network.target
#
[Service]
Type=simple
ExecStart=/usr/bin/node server
Restart=always
# Consider creating a dedicated user for Wiki.js here:
User=nobody
Environment=NODE_ENV=production
WorkingDirectory=/chemin/installation/wikijs
#
[Install]
WantedBy=multi-user.target
- Recharger systemctl :
systemctl daemon-reload - Lancer le service :
systemctl start wiki - Activer le service au démarrage :
systemctl enabe wiki
¶ Configurer l'authentification ActiveDirectory par LDAP (OPTIONNEL)
- Se rendre dans http://ip_wiki/a/auth
- Selectionner LDAP/Active Directory
- Renseigner les champs :
Il faut que l'utilisateur Admin ait les droits de lecture sur l'AD
Il est obligatoire que les utilisateurs aient un champs mail non vide sur l'AD, sinon ils ne pourront pas s'enregistrer sur WikiJS
Il est possible de filtrer les domaines des emails utilisés pour s'enregistrer. Cela est utile si on veut réserver l'accès au Wiki uniquement dans l'entreprise.