moby / moby/buildkit

Running Buildkitd.exe standalone under Windows

Open
#6,440 2 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

status/triage
Dominant language
Go
Stars
10.3k
Forks
1.5k
Avg merge
1d 23h
Merged PRs (30d)
48

Description

Description

Currently, when trying to run buildkitd.exe as a normal process under Windows, an explicit worker would be required.

C:>buildkitd
time="2025-12-22T17:11:14+01:00" level=warning msg="skipping containerd worker, as "\\\\.\\pipe\\containerd-containerd" does not exist"
buildkitd: no worker found, rebuild the buildkit daemon?
main.newWorkerController
/src/cmd/buildkitd/main.go:911
main.newController
/src/cmd/buildkitd/main.go:804
main.main.func3
/src/cmd/buildkitd/main.go:362
github.com/urfave/cli.HandleAction
/src/vendor/github.com/urfave/cli/app.go:524
github.com/urfave/cli.(*App).Run
/src/vendor/github.com/urfave/cli/app.go:286
main.main
/src/cmd/buildkitd/main.go:429
runtime.main
/usr/local/go/src/runtime/proc.go:285
runtime.goexit
/usr/local/go/src/runtime/asm_amd64.s:1693

No default worker would be available under Windows, even running the process as an Administrator

How such support could be implemented to be able to run Buildkitd standalone natively on Windows?

I can think about leveraging CIM/CIMFS - https://github.com/containerd/containerd/issues/8346 in Windows - Host Compute Service Shim (hcsshim) as done in Containerd.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start in cmd/buildkitd/main.go at the worker-controller and startup locations shown in the stack trace: lines 362, 804, and 911. Trace how workers are selected on Windows and define what is needed for buildkitd.exe to run standalone with an available default worker.

Written by the indexing model from the issue text.

Assessment

Tech stack
go
Domain
build-system
Issue type
Feature
Difficulty
5/5
Estimated time
Over a week
Activity status
Stale
Clarity
Needs clarification
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.