How to Install Wiki.js on FreeBSD 11

Wiki.js is a free and open source, modern wiki app built on Node.js, MongoDB, Git and Markdown. Wiki.js source code is publicly hosted on Github. This guide will show you how to install Wiki.js on a fresh FreeBSD 11 Vultr instance by using Node.js, MongoDB, PM2, Nginx, Git and Acme.sh.

Requirements

Requirements to run Wiki.js are as follows:

• Node.js version 6.11.1 or later
• MongoDB version 3.2 or later
• Git version 2.7.4 or later
• A web server such as Nginx, Apache, IIS, Caddy, or H2O. This guide will use Nginx.
• A Git-compliant repository (public or private) This is optional
• A minimum of 512MB RAM. It is highly recommended to use a machine with at least 1GB of RAM.
• Domain name with A/AAAA records set up. In this guide we will use wiki.example.com as an example domain.

Before you begin

Tjek FreeBSD-versionen.

uname -ro
# FreeBSD 11.2-RELEASE

Sørg for, at dit FreeBSD-system er opdateret.

freebsd-update fetch install
pkg update && pkg upgrade -y

Installer sudo, vim, unzip, wget, git, bashog socatpakker, hvis de ikke er til stede på dit system.

pkg install -y sudo vim unzip wget git bash socat

Opret en ny brugerkonto med dit foretrukne brugernavn (vi bruger johndoe).

adduser

# Username: johndoe
# Full name: John Doe
# Uid (Leave empty for default): <Enter>
# Login group [johndoe]: <Enter>
# Login group is johndoe. Invite johndoe into other groups? []: wheel
# Login class [default]: <Enter>
# Shell (sh csh tcsh nologin) [sh]: bash
# Home directory [/home/johndoe]: <Enter>
# Home directory permissions (Leave empty for default): <Enter>
# Use password-based authentication? [yes]: <Enter>
# Use an empty password? (yes/no) [no]: <Enter>
# Use a random password? (yes/no) [no]: <Enter>
# Enter password: your_secure_password
# Enter password again: your_secure_password
# Lock out the account after creation? [no]: <Enter>
# OK? (yes/no): yes
# Add another user? (yes/no): no
# Goodbye!

Kør visudokommandoen, og fjern kommentering af %wheel ALL=(ALL) ALLlinjen, for at tillade medlemmer af wheelgruppen at udføre enhver kommando.

# Uncomment by removing the hash (#) sign
%wheel ALL=(ALL) ALL

Skift nu til din nyoprettede bruger.

su - johndoe

BEMÆRK: Erstat johndoemed dit brugernavn.

Indstil tidszonen.

sudo tzsetup

Installer Node.js

Wiki.js kræver Node.js 6.11.1 eller nyere, så vi skal først installere den relevante version af Node.js.

Installer Node.js og NPM.

sudo pkg install -y node8 npm-node8

Tjek versionerne.

node -v && npm -v
# v8.12.0
# 6.4.1

Installer MongoDB

Wiki.js bruger MongoDB som en databasemotor.

Installer MongoDB.

sudo pkg install -y mongodb36

Tjek versionen.

mongo --version | head -n 1 && mongod --version | head -n 1
# MongoDB shell version v3.6.6
# db version v3.6.6

Aktiver og start MongoDB.

sudo sysrc mongod_enable=yes
sudo service mongod start

Installer Acme.sh og få et Let's Encrypt-certifikat ( valgfrit )

Det er ikke nødvendigt at sikre din wiki med HTTPS, men det er en god praksis at sikre trafikken på dit websted. For at opnå et SSL-certifikat fra Let's Encrypt vil vi bruge Acme.sh klient. Acme.sh er en ren unix shell-software til at opnå SSL-certifikater fra Let's Encrypt med nul afhængigheder. Det gør det meget let i forhold til nogle andre Acme-protokolklienter, der kræver mange afhængigheder for at køre med succes.

Download og installer Acme.sh.

sudo mkdir /etc/letsencrypt
git clone https://github.com/Neilpang/acme.sh.git
cd acme.sh
sudo ./acme.sh --install --home /etc/letsencrypt --accountemail [email protected]
cd ~

Tjek acme.shversionen.

/etc/letsencrypt/acme.sh --version
# v2.8.0

Få RSA- og ECDSA-certifikater for wiki.example.com.

# RSA 2048
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d wiki.example.com --ocsp-must-staple --keylength 2048
# ECDSA/ECC P-256
sudo /etc/letsencrypt/acme.sh --issue --standalone --home /etc/letsencrypt -d wiki.example.com --ocsp-must-staple --keylength ec-256

Efter at have kørt kommandoerne ovenfor, vil dine certifikater og nøgler være i følgende mapper:

• RSA: /etc/letsencrypt/wiki.example.com
• ECC/ECDSA: /etc/letsencrypt/wiki.example.com_ecc

NOTE: Don't forget to replace wiki.example.com with your domain name.

After obtaining certificates from Let's Encrypt, we need to configure Nginx to take advantage of them.

Install and configure Nginx

Wiki.js can run without any actual web server, however it is highly recommended to put a standard web server in front of it. This ensures you can use features like SSL, multiple websites, caching and others. We will use Nginx in this tutorial, but any other server will do, you just need to configure it properly.

Install Nginx.

sudo pkg install -y nginx

Check the version.

nginx -v
# nginx version: nginx/1.14.0

Enable and start Nginx.

sudo sysrc nginx_enable=yes
sudo service nginx start

Configure Nginx as a HTTPS (if you use SSL) reverse proxy for the Wiki.js application.

Run sudo vim /usr/local/etc/nginx/wiki.js.conf and populate it with the basic reverse proxy configuration below.

server {

  listen [::]:443 ssl http2;
  listen 443 ssl http2;
  listen [::]:80;
  listen 80;

  server_name wiki.example.com;

  charset utf-8;
  client_max_body_size 50M;

  # RSA
  ssl_certificate /etc/letsencrypt/wiki.example.com/fullchain.cer;
  ssl_certificate_key /etc/letsencrypt/wiki.example.com/wiki.example.com.key;
  # ECDSA
  ssl_certificate /etc/letsencrypt/wiki.example.com_ecc/fullchain.cer;
  ssl_certificate_key /etc/letsencrypt/wiki.example.com_ecc/wiki.example.com.key;

  location / {
    proxy_set_header Host $http_host;
    proxy_set_header X-Real-IP $remote_addr;
    proxy_pass http://127.0.0.1:3000;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_next_upstream error timeout http_502 http_503 http_504;
  }

}

The only thing you need to change in the config above is the server_name directive, and potentially the proxy_pass directive if you decide to configure some port other than 3000. Wiki.js uses port 3000 by default. Save the file and exit with : + W + Q

Now we need to include the wiki.js.conf file in the main nginx.conf file.

Run sudo vim /usr/local/etc/nginx/nginx.conf and add the following line to the http {} block.

include wiki.js.conf;

Check the configuration.

sudo nginx -t

Reload Nginx.

sudo service nginx reload

Install Wiki.js

Create an empty document root folder where Wiki.js will be installed.

sudo mkdir -p /usr/local/www/wiki.example.com

Navigate to the document root folder.

cd /usr/local/www/wiki.example.com

Change ownership of /usr/local/www/wiki.example.com folder to user johndoe.

sudo chown -R johndoe:johndoe /usr/local/www/wiki.example.com

From the /usr/local/www/wiki.example.com folder, run the following commands to download and install Wiki.js.

curl -sSo- https://wiki.js.org/install.sh | bash

VERSION=$(curl -L -s -S https://beta.requarks.io/api/version/stable)
curl -L -s -S https://github.com/Requarks/wiki/releases/download/v$VERSION/wiki-js.tar.gz | tar -f - -xz -C .
curl -L -s -S https://github.com/Requarks/wiki/releases/download/v$VERSION/node_modules.tar.gz | tar -f - -xz -C .
cp -n config.sample.yml config.yml

You can run the following command in order to view the currently installed version of Wiki.js.

node wiki --version
# 1.0.102

Once the installation is completed, you'll be prompted to run the configuration wizard.

Start the configuration wizard by running.

node wiki configure

This will notify you to navigate to http://localhost:3000 to configure Wiki.js. If you have Nginx in front of Wiki.js, then it means you can open your domain name (e.g. http://wiki.example.com) instead of going to localhost.

Using your web browser, navigate to http://wiki.example.com and follow the on-screen instructions. All the settings entered during the configuration wizard are saved in the config.yml file. The configuration wizard will automatically start Wiki.js for you.

Install and setup PM2 process manager

By default, Wiki.js will not start automatically after a system reboot. In order to make it start on boot, we need to install and setup PM2 process manager.

Install PM2 globally via npm.

sudo npm install -g pm2

Check the version.

pm2 -v
# 3.2.2

Navigate to your document root folder if you are not already there and stop Wiki.js.

cd /usr/local/www/wiki.example.com
node wiki stop

Start Wiki.js via PM2.

pm2 start server/index.js --name "Wiki.js"

List process managed by PM2.

pm2 list

Tell PM2 to configure itself as a startup service by running:

pm2 startup

Finally, save the current PM2 configuration by running the command:

pm2 save

Your Wiki.js instance now runs as a background process, using PM2 as its process manager.