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.