Get Started with Hippo CMS - Enterprise Java Content management system - Hippo CMS

Get Started with Hippo CMS

This Get Started tutorial helps you to get up and running with your first Hippo CMS implementation project.

Before you start, check out the prerequisites.

We recommend you follow the full tutorial and start with Create the Project.

Alternatively, take a shortcut and follow the abbreviated steps below.

Step 1: Create a project using the Hippo CMS Maven archetype:

mvn org.apache.maven.plugins:maven-archetype-plugin:2.4:generate \
-DarchetypeRepository= \
-DarchetypeGroupId=org.onehippo.cms7 \
-DarchetypeArtifactId=hippo-project-archetype \

For Windows use:

mvn org.apache.maven.plugins:maven-archetype-plugin:2.4:generate -DarchetypeRepository= -DarchetypeGroupId=org.onehippo.cms7 -DarchetypeArtifactId=hippo-project-archetype -DarchetypeVersion=12.2.0
Do not use special characters such as dot or dash in the artifactId. Also, avoid using 'cms' or 'hippo' as artifactId because these are known to cause naming conflicts.

Type ‘n’ at the prompt if you want to customize your project name or other parameters.

Step 2: Build the project:

cd myhippoproject
mvn clean verify

Step 3: Run Hippo CMS:

mvn -Drepo.path=storage

This starts a local Tomcat container and deploys the following web applications in it:

Hippo CMS UI at http://localhost:8080/cms

Use admin/admin or editor/editor or author/author as username/password combination. These users have admin, editor and author roles respectively. Browse the End User Manual to learn about creating, editing and publishing content as well as user management.


Hippo CMS Console at http://localhost:8080/cms/console

The Console is a power tool for advanced repository operations for use by developers and administrators.


Essentials at http://localhost:8080/essentials

The Essentials setup application provides a Feature Library from which features can be added to your project.

The first time you use the application it will show a setup screen. Read carefully and if needed, change the default parameters before clicking on Get Started.

Choose from a variety of features in the library to customize content, layout, integrations, SEO and much more. Click 'Install Feature' to add it to your project. Once installed they appear in the installed features tab where you can configure them.



Website at http://localhost:8080/site

The website will initially be empty. Once you have added some features from the library to the site it will render them using a default bootstrap theme.


Step 4: Build your website: 

You can now customize your newly added features or create your own. Check out our tutorial on creating a working website with Hippo CMS or take a deeper dive with our Hello world example.

If you get stuck, check out the troubleshooting and documentation pages or reach out to the community through the forum.