Wiki.js is a modern open source wiki application used to write all documentation & web content in the widely used and simple Markdown format using the built-in visual editor. It was built on Node.js, Git, and Markdown. Wiki.js allows the saving of your content directly into Markdown (.md) files & it synced with your remote Git repository.

Here are some salient features of wiki.js

Salient Features of Wiki.js

• Easy & free to use
• Open source product
• Specially designed for the modern web
• Add, edit or delete content in simple Markdown format
• Integrated Access Control: Local db or external authentication providers like Microsoft Account, Google Account, Facebook, Github etc.
• It is light & more powerful.
• having built-in search engine.

Requirements:

• Minimum Node.js 10.x
• Redis cache
• Minimimum Git 2.x
• Git repo (public or private) (optional)

Installing Wiki.js on CentOS 8

Step 1: Updating your system

sudo yum -y update

Setting time zone.

sudo timedatectl list-timezones
sudo timedatectl set-timezone 'Asia/Karachi'

Step 2: Install Requirements

Install the required package for wiki.js

1.Installing git, unzip and epel-release

sudo yum install -y epel-release git vim wget curl unzip socat

2.Installing Node.js

curl -sL https://rpm.nodesource.com/setup_12.x | sudo bash -
sudo yum install -y nodejs nginx

3.Installing MariaDB server.

sudo yum -y install @mariadb
sudo systemctl enable --now mariadb
sudo mysql_secure_installation

After installation of MariaDB, create DB user and db.

$ mysql -u root -p
 CREATE DATABASE wiki;
 GRANT ALL PRIVILEGES ON wiki.* TO 'wikijs'@'localhost' IDENTIFIED BY 'Your_Password_Here';
 FLUSH PRIVILEGES;
 QUIT;

4.Installing Redis

sudo yum -y install redis
sudo systemctl enable --now redis

Check that redis is working properly

[sabi@localhost ~]$ systemctl status redis
 ● redis.service - Redis persistent key-value database
    Loaded: loaded (/usr/lib/systemd/system/redis.service; enabled; vendor prese>
   Drop-In: /etc/systemd/system/redis.service.d
            └─limit.conf
    Active: active (running) since Tue 2019-12-24 06:28:41 PKT; 13s ago
  Main PID: 12599 (redis-server)
     Tasks: 4 (limit: 4922)
    Memory: 3.4M
    CGroup: /system.slice/redis.service
            └─12599 /usr/bin/redis-server 127.0.0.1:6379
 Dec 24 06:28:41 localhost.localdomain systemd[1]: Starting Redis persistent key>
 Dec 24 06:28:41 localhost.localdomain systemd[1]: Started Redis persistent key->
 lines 1-13/13 (END)

Now, we move towards the installation of wiki.js on centos 8 by updating our system.

Step 3: Creat a dedicated user for Wiki.js

You will require a dedicated user for running wiki.js application.

sudo groupadd --system wiki
sudo useradd -s /sbin/nologin --system -g wiki wiki

Step 4: Download Wiki.js

You can download the latest release of Wiki.js from the Github release page.

curl -s https://api.github.com/repos/Requarks/wiki/releases/latest \
  | grep browser_download_url \
  | grep -v windows \
  | cut -d '"' -f 4 \
  | wget -qi -

After the download get completed, extract the packages to your desired location.

sudo mkdir /srv/wiki
sudo tar zxf wiki-js.tar.gz -C /srv/wiki

Now, create a configuration file from the provided template.

cd /srv/wiki
sudo cp config.sample.yml config.yml

Edit the configuration file and provide the details about DB, redis and ports.

#
 Wiki.js - CONFIGURATION
 #
 Full documentation + examples:
 https://docs.requarks.io/install
 ---------------------------------------------------------------------
 Port the server should listen to
 ---------------------------------------------------------------------
 port: 3000
 ---------------------------------------------------------------------
 Database
 ---------------------------------------------------------------------
 Supported Database Engines:
 - postgres = PostgreSQL 9.5 or later
 - mysql = MySQL 8.0 or later (5.7.8 partially supported, refer to docs)
 - mariadb = MariaDB 10.2.7 or later
 - mssql = MS SQL Server 2012 or later
 - sqlite = SQLite 3.9 or later
 db:
   type: postgres
   # PostgreSQL / MySQL / MariaDB / MS SQL Server only:
host: localhost
   port: 5432
   user: wikijs
   pass: wikijsrocks
   db: wiki
   ssl: false
   # SQLite only:
   storage: path/to/database.sqlite
 #
 ADVANCED OPTIONS
 #
 Do not change unless you know what you are doing!
 ---------------------------------------------------------------------
 SSL/TLS Settings
 ---------------------------------------------------------------------
 Consider using a reverse proxy (e.g. nginx) if you require more
 advanced options than those provided below.
 ssl:
   enabled: false
 # Certificate format, either 'pem' or 'pfx':
   format: pem
Using PEM format:
 key: path/to/key.pem
   cert: path/to/cert.pem
   # Using PFX format:
   pfx: path/to/cert.pfx
   # Passphrase when using encrypted PEM / PFX keys (default: null):
   passphrase: null
   # Diffie Hellman parameters, with key length being greater or equal
   # to 1024 bits (default: null):
   dhparam: null
 # Listen on this HTTP port and redirect all requests to HTTPS.
   # Set to false to disable (default: 80):
   redirectNonSSLPort: 80
 ---------------------------------------------------------------------
 Database Pool Options
 ---------------------------------------------------------------------
 Refer to https://github.com/vincit/tarn.js for all possible options
 pool:
   # min: 2
   # max: 10
 ---------------------------------------------------------------------
IP address the server should listen to
 ---------------------------------------------------------------------
 Leave 0.0.0.0 for all interfaces
 bindIP: 0.0.0.0
 ---------------------------------------------------------------------
 Log Level
 ---------------------------------------------------------------------
 Possible values: error, warn, info (default), verbose, debug, silly
 logLevel: info
 ---------------------------------------------------------------------
 Upload Limits
 ---------------------------------------------------------------------
 If you're using a reverse-proxy in front of Wiki.js, you must also
 change your proxy upload limits!
 uploads:
   # Maximum upload size in bytes per file (default: 5242880 (5 MB))
   maxFileSize: 5242880
   # Maximum file uploads per request (default: 20)
   maxFiles: 10
---------------------------------------------------------------------
 Offline Mode
 ---------------------------------------------------------------------
 If your server cannot access the internet. Set to true and manually
 download the offline files for sideloading.
 offline: false
 ---------------------------------------------------------------------
 Data Path
 ---------------------------------------------------------------------
 Writeable data path for Wiki.js, mainly for cache and user uploads.
 dataPath: ./data
                                                               113,1         Bot

After finishing all these, its time to test the Wiki.js configuration

Type the below command to test configuration. You will see the output similar to the image below:

[sabi@localhost wiki]$ sudo node server
 [sudo] password for sabi: 
 Loading configuration from /srv/wiki/config.yml… OK
 2019-12-24T01:40:42.220Z [MASTER] info: =======================================
 2019-12-24T01:40:42.223Z [MASTER] info: = Wiki.js 2.0.12 ======================
 2019-12-24T01:40:42.223Z [MASTER] info: =======================================
 2019-12-24T01:40:42.223Z [MASTER] info: Initializing…
 2019-12-24T01:40:42.842Z [MASTER] info: Connecting to database…

Step 5: Configure Wiki.js service

Run the below command to run Wiki.js application as a service.

sudo vim/etc/systemd/system/wiki.service

Paste the given data to the file.

[Unit]
 Description=Wiki.js
 After=network.target
 [Service]
 Type=simple
 ExecStart=/usr/bin/node server
 Restart=always
 User=wiki
 Environment=NODE_ENV=production
 WorkingDirectory=/srv/wiki
 [Install]
 WantedBy=multi-user.target

Allow user permission for the directory.

sudo chown -R wiki:wiki /srv/wiki

Reload & start services.

sudo systemctl daemon-reload
sudo systemctl enable --now wiki.service

Make sure that status is working

systemctl status wiki

Bind the service to TCP port 3000

$ ss -tunelp | grep 3000
tcp   LISTEN  0       128                  0.0.0.0:3000           0.0.0.0:*      uid:977 ino:283510 sk:e <->  

Step 6: Install and Configure Nginx reverse proxy

Run the given command to install nginx services.

sudo yum -y install nginx
sudo systemctl enable --now nginx

Allow firewall.

sudo firewall-cmd --add-service=http --permanent
sudo firewall-cmd --reload

Configure SELinux

sudo semanage port -a -t http_port_t -p tcp 3000
sudo setsebool -P httpd_can_network_connect 1

Create new configuration file for wiki.js

sudo vim /etc/nginx/conf.d/wikijs.conf

Now, add the below data into it.

server {
     listen      80;
     server_name wiki.example.com;
 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; }
 }

Check the nginx configuration file and restart services.

$ sudo nginx -t
nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

$ sudo systemctl restart nginx

Now, open the URL on the web browser to finish Wiki.Js installation on CentOS 8.

Provide credential details and Click “Install” button.

It will finalize your Installation.

Provide the details to login.

Click on Create Home Page.

Congratulations! You have successfully installed wiki.js on your CentOS 8. Enjoy it!

The post How To Install wiki.js on CentOS 8 appeared first on Linux Windows and android Tutorials.