Happy New Year, readers!

This is my first blog for the 2026 and I am willing to post more blogs this year. So, let’s get started!

I wanted to try something new with custom component on SItecore’s headless JSS with Next.js and for that I was trying to setup the boilerplate on my local machine as per the steps mentioned in the Sitecore’s development documentation here.

The Issue

After the initialization, when I hit the .\up.ps1 command, I get below error message.

Waiting for CM to become available...
C:\Projects\sitecore\jss\MyNextJsProject\up.ps1 : Timeout waiting for Sitecore CM to become available via Traefik
proxy. Check CM container logs.
At line:1 char:1
+ .\up.ps1
+ ~~~~~~~~
    + CategoryInfo          : NotSpecified: (:) [Write-Error], WriteErrorException
    + FullyQualifiedErrorId : Microsoft.PowerShell.Commands.WriteErrorException,up.ps1
   

The solution

From above error message, I checked the logs in the folder \docker\data\cm. In the logs, there are errors for a solr indexes. But, I am sure from the past experience, these index error should not stop traefik proxy services to reach out to CM hosts.

Next step is to check the traefik’s http configuration on the portal. For that use the url http://localhost:8079/dashboard/

This is the indication that there is something not right with the certificates needed for the ID and CM services. Checked and confirmed the valid wildcard certificates present at the path \docker\traefik\certs and that exact path is also configured correctly as volumes for the traefik service in docker-compose-override.yml

So, what is wrong now…!!!???

After few hours of debugging and googling… it turns out that the docker desktop version I am using is the culprit. The version I am using is the latest (at the time of writing this blog) 4.55.0 and the recommended version is 4.40.

I downgraded to the Docker Desktop 4.40, rerun all the images with rerun the .\up.ps1 command and it fired up all the containers without any error.

Update

I did try with Docker Desktop 4.44 and it is working absolutely fine with it as well.

Refs:
https://sitecore.stackexchange.com/questions/40178/issue-about-setting-up-local-sitecore-xm-cloud-with-docker-desktop