Getting started with Headless development using Sitecore Headless SDKs and Docker are very easy. All you need to do is to
  1. Create a Headless app using command "npx [email protected]" following the instructions here
  2. When you want to connect with a real Sitecore instance running on Docker, just use one of the docker-examples then connect following the examples here (It is a remote Sitecore instance in this case)

The Issue

When deploying the JSS app to Sitecore using the command
jss deploy app -c -d
You may get the following errors:
Wrote sitecore\package\
Sending package sitecore\package\ to https://cm.dockerexamples.localhost/sitecore/api/jss/import...
Unexpected response from import service:
Status message: Forbidden
Status: 403


  1. Set "debugSecurity" to true in "\App_Config\Include\zzz\sitecore-jss-app.deploysecret.config" file that is deployed to your Sitecore instance.
  2. Then run the jss deploy app command again with "--debugSecurity" like below
jss deploy app -c -d --debugSecurity

You can then check the logs in jss deploy app command comparing to the logs from the Sitecore instance. You will see the difference here is caused by "Deployment security factors" in jss and "Server-side security factors" in Sitecore CM have the URLs in https vs http.

This is a security feature and the reason to our issue being that instances in docker are exposed via traefik on https when accessed from host machine, but within docker the request is received on http.

The fix is to make the "security factors" match from the both sides.


There are 2 solutions to this. One is more hacky but quicker than the other one.

Solution 1: The hacky and quick one. Change the npm package so it is requesting on https but generates the security headers in http.

  1. In your JSS app
  2. Find file "\node_modules\@sitecore-jss\sitecore-jss-dev-tools\dist\cjs\package-deploy.js",
  3. Find the 2 lines that start with "const factors ="
  4. Append ".replace("https","http")" after "options.importServiceUrl"

Solution 2: The more proper one. Enable http on traefik for CM in docker setup.

  1. In your Sitecore "docker-compose.override.yml" file
    1. Add below to cm, then restart docker containers
      - 80:80
  1. In the JSS app, scjssconfig.json file

The solution requires port 80 not being used in your local machine. Which should be the case if you have worked with Sitecore in docker for a while locally or planning to do so. If not, using a different port number is actually very tricky and can easily go down a rabbit hole. Some readings here:
Which I'd rather not to because the point of using Sitecore with docker is to allow quick and efficient ways to set up local environments and to start development right away.

Notes: All above are based on Sitecore 10.2 XP0 and Sitecore JSS NextJS 20.1.3