How to Install Wiki.js on Fedora

Wiki.js is a free and open-source wiki software solution written in JavaScript and running on the Node.js runtime. It is cross-platform and is compatible with PostgreSQL, MySQL, MariaDB, MS SQL Server, or SQLite. It offers an intuitive admin panel that allows you to manage all aspects of your wiki. It has a built-in visual editor that allows you to write all content in Markdown files and sync with your remote Git repository.

In this post, we will show you how to install Wiki.js on Fedora Linux.

In This Article

• Install Nginx and MariaDB
• Configure MariaDB Database
• Download Wiki.js
• Create a Systemd Service File for Wiki.js
• Configure Nginx Virtual Host
• Access Wiki.js

Step 1 – Install Nginx and MariaDB

Before starting, you will need to install Nginx, MariaDB, Redis, and Node.js on your server. You can install all of them using the following command.

dnf install nginx mariadb-server nodejs npm redis -y

Once all the packages are installed, start and enable all required services.

systemctl start nginx mariadb redis
systemctl enable nginx mariadb redis

Step 2 – Configure MariaDB Database

Wiki.js uses MariaDB as a database backend, so you will need to create a database and user for Wiki.js.

First, connect to the MariaDB shell.

mysql

Next, create a database and user for Wiki.js.

CREATE DATABASE wikijs;
GRANT ALL PRIVILEGES ON wikijs.* TO 'wikijs'@'localhost' IDENTIFIED BY 'password';

Next, flush the privileges and exit from the MariaDB shell.

FLUSH PRIVILEGES;
QUIT;

Step 3 – Download Wiki.js

First, download the latest version of Wiki.js from Git Hub.

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

Next, create a directory for Wiki.js and extract the downloaded file inside that directory.

mkdir -p /var/www/html/wikijs
tar zxf wiki-js.tar.gz -C /var/www/html/wikijs

Next, navigate to the Wiki.js directory and copy the sample configuration file.

cd /var/www/html/wikijs
cp config.sample.yml config.yml

Next, edit the Wiki.js configuration file.

nano config.yml

Change the following lines.

port: 3000

  type: mariadb 

  host: localhost
  port: 3306
  user: wikijs
  pass: 'password'
  db: wikijs
  
bindIP: 0.0.0.0

Save and close the file, then verify the configuration using the following command.

node server

If everything is fine, you will get the following output.

Loading configuration from /var/www/html/wikijs/config.yml... OK
2023-09-19T04:50:39.759Z [MASTER] info: =======================================
2023-09-19T04:50:39.762Z [MASTER] info: = Wiki.js 2.5.300 =====================
2023-09-19T04:50:39.762Z [MASTER] info: =======================================
2023-09-19T04:50:39.763Z [MASTER] info: Initializing...
2023-09-19T04:50:40.675Z [MASTER] info: Using database driver mysql2 for mariadb [ OK ]
2023-09-19T04:50:40.688Z [MASTER] info: Connecting to database...
2023-09-19T04:50:40.789Z [MASTER] info: Database Connection Successful [ OK ]
2023-09-19T04:50:41.770Z [MASTER] warn: DB Configuration is empty or incomplete. Switching to Setup mode...
2023-09-19T04:50:41.771Z [MASTER] info: Starting setup wizard...
2023-09-19T04:50:41.980Z [MASTER] info: Starting HTTP server on port 3000...
2023-09-19T04:50:41.981Z [MASTER] info: HTTP Server on port: [ 3000 ]
2023-09-19T04:50:41.990Z [MASTER] info: HTTP Server: [ RUNNING ]
2023-09-19T04:50:41.990Z [MASTER] info: 🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻
2023-09-19T04:50:41.991Z [MASTER] info: 
2023-09-19T04:50:41.991Z [MASTER] info: Browse to http://YOUR-SERVER-IP:3000/ to complete setup!
2023-09-19T04:50:41.991Z [MASTER] info: 
2023-09-19T04:50:41.991Z [MASTER] info: 🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺

Press CTRL+C to stop the server.

Step 4 – Create a Systemd Service File for Wiki.js

Next, create a systemd file to manage the Wiki.js service.

nano /etc/systemd/system/wiki.service

Add the following configuration:

[Unit]
Description=Wiki.js
After=network.target

[Service]
Type=simple
ExecStart=/usr/bin/node server
Restart=always
User=nginx
Environment=NODE_ENV=production
WorkingDirectory=/var/www/html/wikijs

[Install]
WantedBy=multi-user.target

Save and close the file, then change the ownership of the Wiki.js directory.

chown -R nginx:nginx /var/www/html/wikijs

Next, reload the systemd daemon to reload the configuration.

systemctl daemon-reload

Finally, start and enable the Wiki.js service to start at the system reboot.

systemctl enable --now wiki.service

You can check the status of the Wiki.js using the following command.

systemctl status wiki

You will see the following output.

● wiki.service - Wiki.js
     Loaded: loaded (/etc/systemd/system/wiki.service; enabled; vendor preset: disabled)
     Active: active (running) since Tue 2023-09-19 00:51:27 EDT; 4s ago
   Main PID: 4388 (node)
      Tasks: 11 (limit: 2328)
     Memory: 55.8M
        CPU: 1.710s
     CGroup: /system.slice/wiki.service
             └─4388 /usr/bin/node server

Sep 19 00:51:28 fedora node[4388]: 2023-09-19T04:51:28.996Z [MASTER] warn: DB Configuration is empty or incomplete. Switching to Setup mode...
Sep 19 00:51:28 fedora node[4388]: 2023-09-19T04:51:28.996Z [MASTER] info: Starting setup wizard...
Sep 19 00:51:29 fedora node[4388]: 2023-09-19T04:51:29.181Z [MASTER] info: Starting HTTP server on port 3000...
Sep 19 00:51:29 fedora node[4388]: 2023-09-19T04:51:29.182Z [MASTER] info: HTTP Server on port: [ 3000 ]
Sep 19 00:51:29 fedora node[4388]: 2023-09-19T04:51:29.190Z [MASTER] info: HTTP Server: [ RUNNING ]
Sep 19 00:51:29 fedora node[4388]: 2023-09-19T04:51:29.191Z [MASTER] info: 🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻🔻
Sep 19 00:51:29 fedora node[4388]: 2023-09-19T04:51:29.191Z [MASTER] info:
Sep 19 00:51:29 fedora node[4388]: 2023-09-19T04:51:29.191Z [MASTER] info: Browse to http://YOUR-SERVER-IP:3000/ to complete setup!
Sep 19 00:51:29 fedora node[4388]: 2023-09-19T04:51:29.192Z [MASTER] info:
Sep 19 00:51:29 fedora node[4388]: 2023-09-19T04:51:29.192Z [MASTER] info: 🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺🔺

Step 5 – Configure Nginx Virtual Host

Next, create an Nginx virtual host configuration file for Wiki.js.

nano /etc/nginx/conf.d/wikijs.conf

Add the following configuration:

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;
    }
}

Save and close the file, then edit the Nginx main configuration file.

nano /etc/nginx/nginx.conf

Add the following line after http{:

server_names_hash_bucket_size 64;

Save the file, then verify the Nginx configuration.

nginx -t

Output:

nginx: the configuration file /etc/nginx/nginx.conf syntax is ok
nginx: configuration file /etc/nginx/nginx.conf test is successful

Finally, restart the Nginx service to apply the changes.

systemctl restart nginx

Step 6 – Access Wiki.js

Now, open your web browser and access Wiki.js using the URL http://wiki.example.com. You will see the site configuration screen.

Define your admin email, password, and site URL, and click on INSTALL. You will see the Wiki.js login screen.

Provide your admin username and password and click on Log in. You will see the Wiki.js welcome screen.

Click on ADMINISTRATION. You will see the Wiki.js dashboard on the following screen.

Conclusion

In this tutorial, you learned how to install Wiki.js with Nginx on Fedora Linux. You can now explore the Wiki.js administration panel and start creating your own Wiki site within a few minutes. You can now try Wiki.js on dedicated server hosting from Atlantic.Net!