Build your own Docker images for the most recent versions of Sitecore. See IMAGES.md for all images currently available. You can also use this repository (preferably from a fork) from you own build server and have it build and push images to your own private Docker registry.

Jump to the How to use section to get started.

• This repository was created to help consolidate efforts around Sitecore and Docker.
• The code and examples found in this repository are created and maintained by the Community, unsupported by Sitecore.
• Official statement from Sitecore on running in containers, see https://kb.sitecore.net/articles/161310.

Please see CHANGELOG.md.

Please see IMAGES.md.

This repository can build multiple Windows versions. Read more about Windows Container Version Compatibility.

Here is the convention used for Sitecore image tags:

 [REGISTRY/]sitecore-<TOPOLOGY>[-VARIANT]-<ROLE>:<SITECORE_VERSION>-<OS_VERSION>

Example:

 registry.example.com/sitecore-xm-cm:9.2.0-windowsservercore-1903
 \__________________/ \____________/ \___/ \____________________/
           |                 |         |             |
   registry/org/user    repository  sc version   os version

.\Build.ps1 -SitecoreUsername "YOUR dev.sitecore.net USERNAME" -SitecorePassword "YOUR dev.sitecore.net PASSWORD"

This will:

1. Download any missing packages into .\packages, if you have another location with files already present you can call Build.ps1 with the parameter -InstallSourcePath.
2. Build all images of latest Sitecore version on latest LTSC (Long Term Support Channel) Windows version.

Images will always be saved locally but not pushed to any remote registries by default. See Setting up automated builds for details on how to do this.

When completed:

1. For Sitecore 9.3.x
   1. Run Set-LicenseEnvironmentVariable.ps1 -Path C:\license\license.xml (use the PersistForCurrentUser switch to persist the license for future sessions). This will gzip and base64 encode the license file content and save it in $env:SITECORE_LICENSE.
   2. Switch directory to .\windows\tests\9.3.x\ and then run any of the docker-compose files, for example an XM with: docker-compose --file .\docker-compose.xm.yml up
2. For Sitecore 9.2.x
   1. Place your Sitecore license file at C:\license\license.xml, or override location using the environment variable LICENSE_PATH like so: $env:LICENSE_PATH="D:\my\sitecore\licenses"
   2. Switch directory to .\windows\tests\9.x.x\ and then run any of the docker-compose files, for example an XM with: docker-compose --file .\docker-compose.xm.yml up

• A private Docker repository. Any will do, but the easiest is to use a Azure Container Registry.
• A file location that your build agents can reach to store downloads from https://dev.sitecore.net/.

1. Latest Windows 10 or Windows Server 2019 with Hyper-V and Containers features installed.
2. Latest stable Docker engine and cli.

1. PowerShell Core so you can use the PowerShell module.
2. Latest stable Docker engine and cli.

1. Trigger a build on changes to master - to get new versions.
2. Trigger once a week - to get base images updated when Microsoft releases patched images.

Example:

# required, change if you need to build images in other folders such as ".\linux" or ".\legacy"
$imagesPath = (Join-Path $PSScriptRoot "\windows")

# optional, default value is ".\packages". Can be on local machine or a file share.
$installSourcePath = (Join-Path $PSScriptRoot "\packages")

# optional, on Docker Hub it's your username or organization, else it's the hostname of your
# own registry. This parameter is optional but you will not be able to push images to a
# remote registry without.
#
# PLEASE NOTE: DO NOT SPECIFY A PUBLIC REGISTRY!
#
$registry = "YOUR REGISTRY NAME" `

# optional, default value is the latest Sitecore version on latest LTSC version
# of Windows. Set to for example "*" for build everything or "*:9.1.1*1903", "*:9.2.0*1903" to
# only build 9.1.1 and 9.2.0 on Windows 1903.
$tags = "*"

# required
$sitecoreUsername = "YOUR dev.sitecore.net USERNAME"

# required
$sitecorePassword = "YOUR dev.sitecore.net PASSWORD"

# import builder module
Import-Module (Join-Path $PSScriptRoot "\modules\SitecoreImageBuilder") -Force

# restore packages needed for the build, only files missing in $installSourcePath will be downloaded
SitecoreImageBuilder\Invoke-PackageRestore `
    -Path $imagesPath `
    -Destination $installSourcePath `
    -Tags $tags `
    -SitecoreUsername $sitecoreUsername `
    -SitecorePassword $sitecorePassword

# build and push images
SitecoreImageBuilder\Invoke-Build `
    -Path $imagesPath `
    -InstallSourcePath $installSourcePath `
    -Registry $registry `
    -Tags $tags

For IIS based images (such as the roles cm, standalone and cd) we now have a few scripts that can be used as ENTRYPOINT for development and production use.

Using these ENTRYPOINT scripts enables you to observe Sitecore log entries in the STDOUT of containers in the foreground or by using commands such as docker container logs or docker container attach.

C:\tools\entrypoints\iis\Production.ps1 features:

• Adds an UDP appender to all default log4net loggers.
• Starts ServiceMonitor.exe in the background.
• Starts filebeat.exe in the foreground and outputting to STDOUT.
• FileBeat inputs configured:
  • IIS access logs, disabled by default, can be switched using environment variable: ENTRYPOINT_STDOUT_IIS_ACCESS_LOG_ENABLED=true
  • IIS error logs, disabled by default, can be switched using environment variable: ENTRYPOINT_STDOUT_IIS_ERROR_LOG_ENABLED=true
  • Sitecore logs, enabled by default, can be switched using environment variable: ENTRYPOINT_STDOUT_SITECORE_LOG_ENABLED=false

C:\tools\entrypoints\iis\Development.ps1 features:

• Same as Production.ps1.
• Starts the Visual Studio Remote Debugger msvsmon.exe in the background if the Visual Studio Remote Debugger directory is mounted into C:\remote_debugger.
• Starts the Watch-Directory.ps1 script in the background if a directory is mounted into C:\src.

See the cm and cd service in windows/tests/9.x.x/docker-compose.xm.yml for configuration examples.