Start Building for Free
  • windows-server-2022-gui
  • Getting Started
  • How This Image Works
  1. Machine Images
  2. windows-server-2022-gui



windows-server-2022-gui is a Windows Server 2022 VM (machine executor) image with Visual Studio Code created by CircleCI with continuous integration builds in mind.

See the docs page for information on getting started using Windows on CircleCI.

For more customization options, we offer a VM Service as well with dedicated Windows virtual machines running bespoke and static images.

Getting Started

To use the Windows executor and the available Windows images, it is easiest to utilize the Windows orb:

1 2 3 4 5 6 7 8 9 10 11 12 version: 2.1 orbs: win: circleci/windows@5.0 jobs: build: executor: win/server-2022 steps: - run: Write-Host 'Hello, Windows' workflows: my-workflow: jobs: - build

The above example uses the Windows orb Windows orb to easily access the Windows machine executor and image in a standardized way.

To use the image directly in the machine executor, you can use:

1 2 3 4 5 6 7 8 9 10 version: 2.1 jobs: build: machine: image: 'windows-server-2022-gui:current' resource_class: windows.medium shell: powershell.exe -ExecutionPolicy Bypass steps: - run: Write-Host 'Hello, Windows'

Three shells are provided and can be specified within your command. The above uses powershell.exe, but you can run bash and cmd commands with bash.exe or cmd.exe, respectfully

How This Image Works

This image is based on Windows Server 2022 and contains various Linux and Windows utilities needed to run most builds on CircleCI. Images are typically updated and released every month.

Please visit our Discuss forums with any questions, search for common problems, or feature requests.

The past four updates in ascending order:

What's in the Box?

  • Windows Server 2022 Datacenter Edition
  • Git
  • 7zip
  • gzip
  • sysinternals
  • Azure CLI
  • WebPI
  • Azure Service Fabric Runtime
  • Azure Service Fabric SDK
  • Nunit Console Runner
  • Nano
  • Vim
  • jq
  • Go
  • OpenJDK
  • Miniconda
  • Python 2
  • Python 3
  • Node.js
  • Ruby
  • .NET SDK
  • SQL Server Dev Edition
  • Visual Studio Community Edition
  • Visual Studio Build Tools
  • Nuget CLI
  • WinAppDriver
  • Chocolatey

Tagging Scheme

current - This image tag points to the latest, production ready Windows image. This image should be used by projects that want a decent level of stability but would like to get occasional software updates.

edge - This image tag points to the latest version of the Windows image and is built from the HEAD of the main branch. This tag is intended to be used as a testing version of the image with the most recent changes and not guaranteed to be stable

Image Tags

  • 2024.04.1
  • 2024.01.1
  • 2023.11.1
  • 2023.10.1
  • 2023.09.1
  • 2023.08.1
  • 2023.07.1
  • 2023.06.1
  • 2023.05.1
  • 2023.04.1
  • 2023.03.1
  • 2022.08.1
  • 2022.07.1
  • 2022.06.1
  • 2022.04.1
  • current
  • edge
Developer Updates
Get tips to optimize your builds
Or join our research panel and give feedback
By submitting this form, you are agreeing to ourTerms of UseandPrivacy Policy.