This article covers a Hippo CMS version 10. There's an updated version available that covers our most recent release.

Getting Started with Hippo CMS 

Hippo CMS is an open source Java-based CMS. If you have Java 8 and Maven 3+ you can get your own Hippo implementation project up and running in just a few steps.

Run the commands below to launch Hippo Community Edition in minutes!

Windows users: remove line continuation characters ('\') and run commands on a single line.

Step 1: Create the ‘myhippoproject’ from the Hippo maven archetype using the command below.

mvn archetype:generate \
-DarchetypeGroupId=org.onehippo.cms7 \
-DarchetypeArtifactId=hippo-project-archetype \
-DarchetypeVersion=3.2.0 \
-DarchetypeRepository=http://maven.onehippo.com/maven2
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: Go to your project root folder ‘myhippoproject’and build your new project.

cd myhippoproject
mvn clean verify

Step 3: Launch Hippo CMS by running the following command in ‘ myhippoproject’

mvn -Pcargo.run -Drepo.path=storage

Hippo CMS is now running and you are ready to start implementing your Hippo-based website. The following applications are running:

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.

//onehippo-prod.global.ssl.fastly.net/binaries/ninecolumn/content/gallery/connect/trails/getting-started-trail-10.0/cms-10.0-login.png

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

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

//onehippo-prod.global.ssl.fastly.net/binaries/ninecolumn/content/gallery/connect/trails/getting-started-trail-10.0/console.png

Setup Application at  http://localhost:8080/essentials

The 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.

//onehippo-prod.global.ssl.fastly.net/binaries/ninecolumn/content/gallery/connect/trails/getting-started-trail-10.0/essentials-introduction.png

//onehippo-prod.global.ssl.fastly.net/binaries/ninecolumn/content/gallery/connect/trails/getting-started-trail-10.0/essentials-library.png

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.

//onehippo-prod.global.ssl.fastly.net/binaries/ninecolumn/content/gallery/connect/trails/getting-started-trail-10.0/default-site.png

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 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 us on our  Community Forum.