Skip to content

Changing local Docker Image Base OS Versions

Jump to bottom
Rob Earlam edited this page Feb 27, 2024 · 3 revisions

This repository runs locally using Windows Containers. This repositories maintainers intend to keep this repository running against the latest Windows Container versions as possible to reduce image size and increase performance.

If your host OS doesn't match the Windows Container image versions specified in the .env.template file included in the root of the repository, you may need to downgrade the image tags in that file to run the repository locally.

The key images references you will need to check are

  • SITECORE_VERSION=1-ltsc2022
  • EXTERNAL_IMAGE_TAG_SUFFIX=10.2-ltsc2022
  • TOOLS_IMAGE=scr.sitecore.com/tools/sitecore-docker-tools-assets:10.3-ltsc2022
  • TRAEFIK_IMAGE=traefik:v2.11.0-windowsservercore-ltsc2022
  • SOLUTION_BUILD_IMAGE=mcr.microsoft.com/dotnet/framework/sdk:4.8-windowsservercore-ltsc2022
  • SOLUTION_BASE_IMAGE=mcr.microsoft.com/windows/nanoserver:ltsc2022
  • NETCORE_BUILD_IMAGE=mcr.microsoft.com/dotnet/sdk:8.0-nanoserver-ltsc2022
  • NETCORE_RELEASE_IMAGE= mcr.microsoft.com/dotnet/aspnet:8.0-nanoserver-ltsc2022
  • NODEJS_PARENT_IMAGE=mcr.microsoft.com/windows/nanoserver:ltsc2022

Generally speaking, Windows Containers are backwards compatible but are rarely forwards compatible. If you get errors mentioning mismatching OS version then you should check the OS version of your Host and ensure it isn't an older version than any of the images above. If it is then you should change the records above to a lower base OS version.

Clone this wiki locally