Hippo CMS 11 Installation with MySQL with GIT

In this tutorial we are going to install and run Hippo CMS version 11. This tutorial is made with Ubuntu 16.04 and requires default knowledge of the operating system.

Initial setup

Lets start with installing the dependencies which are Java 8 and Maven.

Create hippo project with this command

This will ask all kinds of questions that you’ll find the answer from https://www.onehippo.org/11/trails/getting-started/creating-a-project.html.

For this tutorial you can just click enter and the default will be applied.

Adding GIT to project

Now it’s good time to setup git since we have the basic project files on myhippoproject -folder.


To add MySQL into the project we need to create the actual database for it.

Hippo CMS MySQL configuration

Hippo CMS configuration isn’t the best in the world and it’s quite complex and hard to follow. Finding a certain line from the configuration files can be very hard to pay attention when doing this.

First add Resource to conf/context.xml. Notice username, password and url which configure your MySQL credentials for Hippo.

Then add conf/repository.xml, the file contains a lot of stuff and mostly unnecessary things for us to know right know, so I’ll just add the file here. Most importantly it represents the place for content to be put on to and it’s configuration.

Finally we need to modify our pom.xml file to know about our just created repository.xml and MySQL scheme. So do the following changes in pom.xml:

Before rushing to the next step you should commit your changes:

Build & Run

Now lets build our project.

This downloads some assets and creates the runnable java files. Now we need to create .gitignore file because the created files shouldn’t go to version control. So create .gitignore and add the following in there. Also commit the file in git.

Now we are ready to run the project with this command:

The -Drepo.bootsrap=true is there to ensure that we are creating the system from scratch. If you don’t want to do this after the initial setup, you can just omit it.

Try it out

You should now be able to go and see hippo working.

Happy Hippo CMS:ing!