Install KeystoneJS CMS (Node.js) Platform on Ubuntu 16.04 | 18.04

office 4694143 640

KeystoneJS is an open source content management system (CMS) built on Node.js and MongoDB that helps you develop database-driven websites, applications and APIs in Node.js.. It is the easiest way to build database-driven websites and apps based on Node.js.

KeystoneJS is in use for many kinds of websites, from small nonprofits and large enterprises.

Using KeystoneJS to edit your content on the web should be easy and fun. No need for learning templating and HTML. KeystoneJS hides most of that stuff and focuses on what matters most.….

KeystoneJS offers features that may not be available to other PHP based CMS, like WordPress Joomla or Drupal… All you do is write your content and its instantly published… Other features like permalinks, categories, pages, posts, and custom layouts are all top content and SEO friendly…

For more about KeystoneJS , check its homepage.

This brief tutorial is going to show students and new users how to install KeystoneJS on Ubuntu 16.04 | 18.04 and 18.10 systems.

These are the packages we’re going to be setting up.

  • Ruby version 2.5.3
  • MongoDB

Step 1: Install Ruby

To install Ruby and Rails on Ubuntu, you’ll need  to install some dependencies. To make that happen, install Node.js and Yarn repositories. This will make installing the dependencies easier.

First install these curl and git packages.

sudo apt update
sudo apt install curl git

Than run the commands below to add Node.js and Yarn repositories and keys to your system. Then install some core packages to get your environment going.

curl -sL | sudo -E bash -
curl -sS | sudo apt-key add -
echo "deb stable main" | sudo tee /etc/apt/sources.list.d/yarn.list

sudo apt-get update
sudo apt-get install nodejs yarn zlib1g-dev build-essential libpq-dev libssl-dev libreadline-dev libyaml-dev libsqlite3-dev sqlite3 libxml2-dev libxslt1-dev libcurl4-openssl-dev software-properties-common libffi-dev

When you’re done. continue below:

After adding the repositories and installing necessary packages above, install Ruby with your local profile settings using rbenv. you’ll then use rbenv to install ruby-build.

cd ~/
git clone ~/.rbenv
echo 'export PATH="$HOME/.rbenv/bin:$PATH"' >> ~/.bashrc
echo 'eval "$(rbenv init -)"' >> ~/.bashrc
exec $SHELL

git clone ~/.rbenv/plugins/ruby-build
echo 'export PATH="$HOME/.rbenv/plugins/ruby-build/bin:$PATH"' >> ~/.bashrc
exec $SHELL

After setting up your local profile. run the commands below to install Ruby version 2.5.3. If a newer version is available, replace the version number to that. visit this site to find out Ruby latest versions.

rbenv install 2.5.3
rbenv global 2.5.3

To verify that Ruby is installed, run the commands below:

ruby -v

You should see similar lines as below:

ruby 2.5.3p105 (2018-10-18 revision 65156) [x86_64-linux]

Step 2: Install Node.js

Now that Ruby environment is set up, run the commands below to install Node.js. Run the commands below to install Node.js repository, then install Node.js package.

curl -sL | sudo -E bash -
sudo apt-get install -y nodejs

Now that Node.js is installed, run the commands below to install KeystoneJS.

Step 3: Install MongoDB

MongoDB is the database that KeystoneJS uses. So install MongoDB, ImageMagic before continuing with setting up your website projects.

sudo apt install mongodb
npm install mongodb --save

After installing MongoDB server, open a new terminal window and try.

Then start an interactive mongo prompt by typing the command below:


ctrl+c to exit.

Step 4: Install KeystoneJS

Now that your environment is ready, run the commands below to install KeystoneJS and build your first site.  Next, run the commands below.

npm install imagemagick
sudo npm install -g generator-keystone
sudo npm install -g yo

Next create a folder for your project, then change into the KeystoneJS folder and install there.

mkdir ~/keystonejs
cd ~/keystonejs
yo keystone

The generator will ask a couple of questions about the configuration. Go ahead and select the default options. Say Y when generator asks you if want you include a Blog. In this guide, we will use pug templating engine, and less as a CSS pre-processor.

Once you’ve selected your requirements, the generator will prepare the skeleton of your app, configure the files and install npm dependencies as required.

When you’re done, run the commands below to start the server from inside the keystonejs project folder.

node keystone

Now open your browser and browse to the hostname follow by port # 3000


You should see KeystoneJS home page.

KeystoneJS Ubuntu Install

Next, logon to the back-end and begin creating content.

Use the credential you created for admin above.

KeystoneJS Ubuntu Install

Now you can start building your great content!

Congratulation! You have successfully installed KeystoneJS platform on Ubuntu 16.04 | 18.04 | 18.10

You may also like the post below:

Leave a Reply

Your email address will not be published.

This site uses Akismet to reduce spam. Learn how your comment data is processed.