In 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 https://github.com/Dynalon/mdwiki.git 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/yourAwesomeWiki.com server { listen 80; server_name yourAwesomeWiki.com 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/yourAwesomeWiki.com /etc/nginx/sites-enabled/yourAwesomeWiki.com ~ # ❯❯❯ sudo /etc/init.d/nginx restart
How does it work?
MDwiki will load a file called index.md 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.
Example
Create and upload the following files:
# ❯❯❯ cat config.json { }
# ❯❯❯ cat navigation.md [Home](index.md) [About](about.md)
# ❯❯❯ cat index.md Home Heading ======= ## Home SubHeading
# ❯❯❯ cat about.md About Heading ======= ## About SubHeading
That’s it. Now open your browser and navigate to your domain.
For more info about MDwiki please go to: http://mdwiki.info
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.