How to deploy Habitat over a new Sitecore instance

Quick and simple post - as the title suggests, this is how to deploy Habitat on top of a newly installed Sitecore developer instance (both version 9.1). You should use the general Habitat setup wiki if you want to install Sitecore 9.1 and Habitat at the same time. Why might you want to install a Sitecore vanilla instance first? Perhaps you want to take a look at vanilla Sitecore before looking at Habitat, or perhaps you are curious as to which vanilla files Habitat amend and adds to. By the way, to get Sitecore 9.1 installed locally take a look at my previous blog post.

The Steps

  1. Clone the Habitat repo from https://github.com/Sitecore/Habitat/ 
  2. Ensure all these prerequisites are in place - take a look at https://github.com/Sitecore/Habitat/wiki/02-Resources
  3. In “gulp-config.js” change the value of “var instanceRoot =” to match your Sitecore website
  4. In “publishsettings.targets” change “http://habitat.dev.local” to the host your Sitecore website is accessible on
  5. In “\src\Project\Habitat\code\App_Config\Include\Project\Habitat.Website.config” change “habitat.$(rootHostName)” to the host your Sitecore website is accessible on
  6. In “\src\Project\Habitat\code\App_Config\Environment\Project\Habitat.Dev.config” change “C:\projects\Habitat\src” to the the location you cloned the Habitat repo to
  7. In “src\Project\Common\code\App_Config\Include\Project\Common.Website.config” change the value of <setting name="Analytics.CookieDomain... to the host your Sitecore website is accessible on
  8. From https://github.com/Sitecore/Habitat/wiki/01-Getting-Started follow "2. Build and Deploy Habitat"
  9. From https://github.com/Sitecore/Habitat/wiki/01-Getting-Started follow "3. Rebuild search indexes"

The end.