Setup Sitecore Habitat v9.0 project in simple way

In this article , I would describe how to setup the Sitecore habitat V9.0 project with Sitecore Experience Platform 9.0 rev in very simple way.

I used below system configuration to setup this project:

1. Windows 10 (32/64-bit)
2. IIS 10.0
3. .NET Framework 4.6.2
4. Microsoft Visual Studio 2017
5. Microsoft SQL Server 2017
6. Solr 6.6.2
7. Microsoft PowerShell® version 5.0
8. Web Platform Installer 5.0.
9. Web Deploy 3.6 for Hosting Servers
10. Node-v8.9.4-x64

Follow below steps to setup the project.

A).  Habitat require Sitecore instance. Setup the clean Sitecore 9.0 instance. Ex : http://demo.local.com , Directory location : C:\inetpub\wwwroot\demo.local.com
  For more info visit -  https://dev.sitecore.net/

B). Download the Habitat V9.0 project from Github site : https://github.com/Sitecore/Habitat/
   

Note  : When you download the packages, it is possible that the .ZIP packages are marked as blocked by Microsoft Windows. To continue the installation of the Sitecore Installation Framework, you must first unblock the .ZIP packages.

To unblock a .ZIP package
1. In Windows Explorer, navigate to the folder where you downloaded the .ZIP packages, and right-click the relevant .ZIP file
2. Click Properties.
3. In the Properties dialog box, on the General tab, click Unblock.
4. Click OK.

C). Extract the downloaded file and place it into one folder ex : D:\Sitecore\Projects\Habitat

D). Create a directory "\lib\Sitecore"  inside folder "D:\Sitecore\Projects\Habitat" and copy all sitecore related DLL from already created project (demo.local.com) to D:\Sitecore\Projects\Habitat\lib\Sitecore.

E). Open Habitat.sln in visual studio 2017 and rebuild the solution . It will download all related packages which is required and build the project.

F). Modify the default value in below files as required.

•    \Habitat\publishsettings.targets

• \Habitat\gulp-config.js

• Habitat\code\App_Config\Environment\Project\Habitat.Dev.config

G). Download the Node.Js and install it on system. Download Link : Node.js

H). After downloading, open command prompt in Administrator mode and navigate to root repository : D:\Sitecore\Projects\Habitat. 

Run the "npm install" on command  prompt for installing the all modules to run the gulp to complete all task. 

I).  Post installation of all modules in step G) . Run all the task from Visual Studio Solution.
       Open :  View  >  Other Windows  > Task Runner Explorer in VS 2017
     

J).  Select the below window , right click on Default and run the default task.
      

Uaaa , Finally browse the site and open the Sitecore CMS. Thanks for visiting the article. 

Troubleshooting : 

If you are getting below error : 

Error: MSBuild failed with code 1!

    \gulp-msbuild\lib\msbuild-runner.js:66:25)

    at emitTwo (events.js:87:13)

    at ChildProcess.emit (events.js:172:7)

    at Process.ChildProcess._handle.onexit (internal/child_process.js:200:12)

'Publish-All-Projects' errored after 2.2 min

[01:21:55] Error in plugin 'run-sequence(Publish-Foundation-Projects)'

Note : Above error occurred because of insufficient permission on site.  Provide the suffient permission and execute the task again.