Install MDwiki on an Ubuntu 14.04 VPS

wikiIn this guide, we’ll show you how to install MDwiki on an Ubuntu 14.04 VPS.
MDwiki is a single page CMS/Wiki system built on top of jQuery and Bootstrap3, with responsive layout and it uses Markdown as it’s input markup language.

Login to your server using SSH

ssh username@hostname

Update the system and install all the necessary packages.

~ # ❯❯❯ sudo apt-get -y update && apt-get -y upgrade
~ # ❯❯❯ sudo apt-get -y install software-properties-common python-software-properties git

Install the latest version of Nodejs

~ # ❯❯❯ sudo add-apt-repository ppa:chris-lea/node.js
~ # ❯❯❯ sudo apt-get update && sudo apt-get install nodejs

Pull down the latest MDwiki from github

~ # ❯❯❯ sudo cd ~
~ # ❯❯❯ sudo git clone yourAwesomeWiki
~ # ❯❯❯ sudo cd yourAwesomeWiki
~ # ❯❯❯ sudo make

Install and configure Nginx

~ # ❯❯❯ sudo apt-get install -y nginx

Set the worker_processes to the number of processors in your system. To find out the number of processors in your system and set the worker_processes, run the following command:

~ # ❯❯❯ sudo sed -i "0,/^worker_processes/ s/^worker_processes .*$/worker_processes `grep -c processor /proc/cpuinfo`;/"  /etc/nginx/nginx.conf

Create a new nginx virtual host

~ # ❯❯❯ sudo apt-get vim /etc/nginx/sites-available/
server {
    listen       80;

    access_log /var/log/nginx/wiki-access.log;
    error_log /var/log/nginx/wiki-error.log;
    location / {
        root /home/[yourUsername]/yourAwesomeWiki/dist;
        index mdwiki.html;

symlink and restart Nginx

~ # ❯❯❯ sudo ln -s /etc/nginx/sites-available/ /etc/nginx/sites-enabled/
~ # ❯❯❯ sudo /etc/init.d/nginx restart

How does it work?

MDwiki will load a file called from the same directory as the mdwiki.html by default.
All you have to do is to upload your markdown files in the ‘dist’ directory and access them via the hashbang #! character.


Create and upload the following files:

# ❯❯❯ cat config.json
# ❯❯❯ cat
 # ❯❯❯ cat
Home Heading

## Home SubHeading
# ❯❯❯ cat
About Heading

## About SubHeading

That’s it. Now open your browser and navigate to your domain.

For more info about MDwiki please go to:

Of course you don’t have to do any of this if you use one of our Linux VPS hosting services, in which case you can simply ask our expert Linux admins to install this for you. They are available 24×7 and will take care of your request immediately.

PS. If you liked this post please share it with your friends on the social networks using the buttons on the left or simply leave a reply below. Thanks.

1 thought on “Install MDwiki on an Ubuntu 14.04 VPS”

Leave a Comment

To prove you are human please solve the following *