Get started with Bloomreach


 Get up and running in minutes

 Try out all features

 Access to Bloomreach Community



Before you start, check out the prerequisites.

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

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

Step 1: Create a project using the BloomReach Experience Manager 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=13.3.0
Do not use special characters such as dot or dash in the artifactId, groupId or project name. Also, avoid using 'cms' or 'hippo' as artifactId because these are known to cause naming conflicts.

The Maven command above uses the latest BloomReach Experience Manager release available to the open source community. Do not use special characters such as dot or dash in the artifactId, groupId or project name. Also, avoid using 'cms' or 'hippo' as artifactId because these are known to cause naming conflicts.

BloomReach Experience Manager standard and premium licensees have access to the latest release as listed on the Release Notes Overview page. To use the latest release, make sure to configure the BloomReach Experience Manager Maven repository and in the above Maven command, replace the value of the -DarchetypeRepository argument with and the value of the -DarchetypeVersion argument with the appropriate version number.

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

Step 2: Build the project:

cd myproject
mvn clean verify

Step 3: Run BloomReach Experience Manager:

mvn -Drepo.path=storage

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

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.


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

The Console is a powerful 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 or app: 

You can now customize your newly added features or create your own. Check out our tutorial on creating a working website with BloomReach Experience Manager 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.



Join the Bloomreach developer community and get help, ask your questions and share your knowledge with fellow developers.



Documentation, tutorials, training, blogs and even advanced labs section where experts discuss best practices.