docker · installation

Sitecore XP 10.2.0 and SXA 10.2.0 Demo – Lighthouse – Setup Guide

You’re a Sitecore developer and want to know how to implement the website(s) using Sitecore Experience Accelerator 10.2.0 (aka SXA 10.2.0) on Sitecore Experience Platform 10.2.0 (aka Sitecore XP 10.2.0) and following Helix principles.

If that is the case, you should set up the Sitecore demo – Lighthouse – on your machine so that you’re able to play around with the Sitecore solution example and then learn something.

Note: it can only be deployed inside Docker containers

Prerequisites

  • Windows 1809 or higher
  • >= 16 Gb of memory
  • Sitecore 10 license file located at C:\license\license.xml
  • the latest Docker Desktop

Step-by-step Guide

  1. ensure to set up your docker environment by following https://doc.sitecore.com/xp/en/developers/102/developer-tools/set-up-the-environment.html
  2. ensure the Windows Docker engine experimental features are enabled (to allow the Linux smtp container to run at the same time as the Windows containers)
    • open Docker Desktop and then select Settings => Docker Engine
    • ensure the value of the "experimental" key is set to true
    • lh100_1
    • (optional) ensure the value of the "dns" key is set to ["8.8.8.8"] if any
    • click Apply & Restart button
  3. to avoid any conflicts, we should ensure the following ports are not being used by another process: 443, 8079, 8081, 8984, and 14330
    • stop IIS
    • stop windows services if any
    • quit Skype for sure
  4. download or clone the git repo from Sitecore Demo Platform 10.2.0 to D:\ProjectsSitecore.Demo.Platform
  5. create certificates and initialize the environment file
    • open Windows PowerShell (run as administrator)
    • change directory to D:\Projects\Sitecore.Demo.Platform
    • execute .\init.ps1 -InitEnv -LicenseXmlPath C:\license\license.xml -AdminPassword b
    • lh1010_3
  6. pull the latest demo docker images
    • open Windows PowerShell (run as administrator)
    • change directory to D:\Projects\Sitecore.Demo.Platform
    • execute docker-compose pull
    • lh1010_1
    • hopefully will see something like this after a loooooooooooog operation
    • lh1010_2
  7. let’s spin up the container-based demo instances
    • open Windows PowerShell (run as administrator)
    • change directory to D:\Projects\Sitecore.Demo.Platform
    • execute docker-compose up -d
    • lh1010_4
  8. open a browser, navigate to https://cd.lighthouse.localhost/, we would see the Lighthouse landing page with a full-width carousel and a valid SSL certificate
    • lh1010_5
  9. open a browser, navigate to https://cm.lighthouse.localhost/sitecore, we should be able to login with the superuser user and b password (by default, they’re provided in Step 5)
    • don’t forget to verify the Sitecore version
    • lh1020_1
    • SXA version: access Sitecore item /sitecore/system/Settings/Foundation/Experience Accelerator/Upgrade/Current and then have a look at Version field
    • lh1020_2
  10. open a browser, navigate to http://127.0.0.1:44026/, we should the SMTP container catch-all mailbox for all emails sent by Email eXperience Manager (aka EXM)

Notes

  1. for stopping the demo without losing the changes
    • open Windows PowerShell (run as administrator)
    • change directory to D:\Projects\Sitecore.Demo.Platform
    • execute docker-compose stop
    • lh1010_8
    • start the demo again by executing docker-compose start
    • lh1010_10
  2. for data cleanup
    • open Windows PowerShell (run as administrator)
    • change directory to D:\Projects\Sitecore.Demo.Platform
    • execute docker-compose down
    • execute .\CleanDockerData
    • lh1010_11

Happy Sitecore Demo!

2 thoughts on “Sitecore XP 10.2.0 and SXA 10.2.0 Demo – Lighthouse – Setup Guide

Leave a comment

This site uses Akismet to reduce spam. Learn how your comment data is processed.