Skip to content

Install Sitecore 10.3 with JSS Containers

Posted in :

rbatallas

Sitecore 10.3 with JSS usually is kind of complicated when you are a noob on this topic. Following I will show you all the tricks you need to know.

Tools needed:

  • Docker For Windows (Latest Versions) with Windows Containers enabled
  • Windows PowerShell
  • .Net Framework 4.8
  • .Net Core 3.1
  • Visual Studio 2019 or Visual Studio 2022
  • Node.Js (Latest Version)

At this time we do not need to download Sitecore from the developer’s portal.

Steps

Run Windows PowerShell as Administrator and create a folder in any location

Execute the following command inside the folder

dotnet new -i Sitecore.DevEx.Templates --nuget-source https://sitecore.myget.org/F/sc-packages/api/v3/index.json

Stop all services like:

  • IIS
  • Solr
  • SQL Server

Execute this command in order to create the new solution with all docker files

dotnet new sitecore.nextjs.gettingstarted -n MyProject
Note: you can change the name "MyProject" with your solution's name

Once the scrip is done, go inside your solution's folder and run the following commands:
.\init.ps1 -InitEnv -LicenseXmlPath "<C:\path\to\license.xml>" -AdminPassword "<desired password>"

Before running the up.ps1 script the run the following commands:

dotnet tool restore
setx NODE_EXTRA_CA_CERTS %USERPROFILE%\AppData\Local\mkcert\rootCA.pem

The second command sets a node.js environment variable in order to allow Node to validate self-signed certificates.

You can validate this new environment variable with the following command

$Env:NODE_EXTRA_CA_CERTS

Now, it’s time to execute the up.ps1 script

.\up.ps1

This script will download all images and will configure all containers with Sitecore configurations for JSS.

When prompted, in your browser, log in to Sitecore and accept the device authorization.

Wait for the startup script to open browser tabs for the rendered site and the Sitecore Launchpad.

Leave a Reply

Your email address will not be published. Required fields are marked *