v0.5.3

• go.mod: Remove replace directive of docker/docker and bump up to the latest (#255)
• Bump golang.org/x/sync to 0.14.0 (#256)
• Bump up golang.org/x/crypto to 0.38.0 (#258)

About the binaries

• Minimal(e.g. buildg-v0.5.3-linux-amd64.tar.gz): contains only buildg binary
• Full(e.g. buildg-full-v0.5.3-linux-amd64.tar.gz): contains buildg and its dependencies

Minimal

Extract it to a path like /usr/local/bin/ or ~/bin/

list of files

-rwxr-xr-x root/root  29909144 2025-05-12 13:10 buildg

Full

Extract it to a path like /usr/local/ or ~/.local

list of files

drwxr-xr-x 0/0               0 2025-05-12 13:12 bin/
-rwxr-xr-x 0/0        29876376 2025-05-12 13:12 bin/buildg
-rwxr-xr-x 0/0        12235661 2025-03-10 02:16 bin/rootlessctl
-rwxr-xr-x 0/0        14172281 2025-03-10 02:16 bin/rootlesskit
-rwxr-xr-x 0/0        15944952 2025-05-12 13:12 bin/runc
-rwxr-xr-x 0/0         2383224 2025-05-12 13:12 bin/slirp4netns
drwxr-xr-x 0/0               0 2025-05-12 13:12 share/
drwxr-xr-x 0/0               0 2025-05-12 13:12 share/doc/
drwxr-xr-x 0/0               0 2025-05-12 13:12 share/doc/buildg-full/
-rw-r--r-- 0/0             323 2025-05-12 13:12 share/doc/buildg-full/README.md
-rw-r--r-- 0/0             508 2025-05-12 13:12 share/doc/buildg-full/SHA256SUMS

---

The sha256sum of SHA256SUM is 971241ae1361327cbd77cc491afae5c9f4077b9043e436bfcb40c6fbf393ca28

v0.5.2

Notable Changes

• Fix --startup-timeout didn't work (#253)
• Add duration of timeout to the log (#254)

About the binaries

• Minimal(e.g. buildg-v0.5.2-linux-amd64.tar.gz): contains only buildg binary
• Full(e.g. buildg-full-v0.5.2-linux-amd64.tar.gz): contains buildg and its dependencies

Minimal

Extract it to a path like /usr/local/bin/ or ~/bin/

list of files

-rwxr-xr-x root/root  29851800 2025-04-25 14:13 buildg

Full

Extract it to a path like /usr/local/ or ~/.local

list of files

drwxr-xr-x 0/0               0 2025-04-25 14:16 bin/
-rwxr-xr-x 0/0        29819032 2025-04-25 14:15 bin/buildg
-rwxr-xr-x 0/0        12235661 2025-03-10 02:16 bin/rootlessctl
-rwxr-xr-x 0/0        14172281 2025-03-10 02:16 bin/rootlesskit
-rwxr-xr-x 0/0        15944952 2025-04-25 14:15 bin/runc
-rwxr-xr-x 0/0         2383224 2025-04-25 14:16 bin/slirp4netns
drwxr-xr-x 0/0               0 2025-04-25 14:16 share/
drwxr-xr-x 0/0               0 2025-04-25 14:16 share/doc/
drwxr-xr-x 0/0               0 2025-04-25 14:16 share/doc/buildg-full/
-rw-r--r-- 0/0             323 2025-04-25 14:16 share/doc/buildg-full/README.md
-rw-r--r-- 0/0             508 2025-04-25 14:16 share/doc/buildg-full/SHA256SUMS

---

The sha256sum of SHA256SUM is 32e27acf6246b728a481ceda4c138bdd49fadc2913cd5a5fab9d80c2d5104a1f

v0.5.1

Notable Changes

• Updated dependencies, thanks to @reneleonhardt (#232, #244)
• Fixed make didn't work in a sandboxed environment, thanks to @CrazyCasta (#215)
• Fixed CI to make use cache-to & cache-from options, thanks to @developer-guy (#86)
• Improved breakpoints command's output format (#89)
• Added --startup-timeout flag to configure timeout of starting buildg (#246)

Note about v0.5.0

v0.5.0 has been tagged but it didn't include the container images due to CI issue. For trying the container images of v0.5, please use buildg newer than v0.5.1.

About the binaries

• Minimal(e.g. buildg-v0.5.1-linux-amd64.tar.gz): contains only buildg binary
• Full(e.g. buildg-full-v0.5.1-linux-amd64.tar.gz): contains buildg and its dependencies

Minimal

Extract it to a path like /usr/local/bin/ or ~/bin/

list of files

-rwxr-xr-x root/root  29851800 2025-04-25 12:21 buildg

Full

Extract it to a path like /usr/local/ or ~/.local

list of files

drwxr-xr-x 0/0               0 2025-04-25 12:24 bin/
-rwxr-xr-x 0/0        29819032 2025-04-25 12:23 bin/buildg
-rwxr-xr-x 0/0        12235661 2025-03-10 02:16 bin/rootlessctl
-rwxr-xr-x 0/0        14172281 2025-03-10 02:16 bin/rootlesskit
-rwxr-xr-x 0/0        15944952 2025-04-25 12:23 bin/runc
-rwxr-xr-x 0/0         2383224 2025-04-25 12:24 bin/slirp4netns
drwxr-xr-x 0/0               0 2025-04-25 12:24 share/
drwxr-xr-x 0/0               0 2025-04-25 12:24 share/doc/
drwxr-xr-x 0/0               0 2025-04-25 12:24 share/doc/buildg-full/
-rw-r--r-- 0/0             323 2025-04-25 12:24 share/doc/buildg-full/README.md
-rw-r--r-- 0/0             508 2025-04-25 12:24 share/doc/buildg-full/SHA256SUMS

---

The sha256sum of SHA256SUM is 9650c92215cb7dab8762be27a7ed71d245f99fffd4a26d4b85975b4fefd4dfe3

v0.4.1

Change

• Remove .m suffix from release binary (#81)

Refer to v0.4.0 release note for other notable changes of v0.4.

About the binaries

• Minimal(e.g. buildg-v0.4.1-linux-amd64.tar.gz): contains only buildg binary
• Full(e.g. buildg-full-v0.4.1-linux-amd64.tar.gz): contains buildg and its dependencies

Minimal

Extract it to a path like /usr/local/bin/ or ~/bin/

list of files

-rwxr-xr-x root/root  23724032 2022-09-05 09:52 buildg

Full

Extract it to a path like /usr/local/ or ~/.local

list of files

drwxr-xr-x 0/0               0 2022-09-05 09:55 bin/
-rwxr-xr-x 0/0        23916544 2022-09-05 09:54 bin/buildg
-rwxr-xr-x 0/0         9443526 2022-05-02 08:24 bin/rootlessctl
-rwxr-xr-x 0/0        10879193 2022-05-02 08:24 bin/rootlesskit
-rwxr-xr-x 0/0        13733640 2022-09-05 09:55 bin/runc
-rwxr-xr-x 0/0         2338128 2022-09-05 09:55 bin/slirp4netns
drwxr-xr-x 0/0               0 2022-09-05 09:55 share/
drwxr-xr-x 0/0               0 2022-09-05 09:55 share/doc/
drwxr-xr-x 0/0               0 2022-09-05 09:55 share/doc/buildg-full/
-rw-r--r-- 0/0             329 2022-09-05 09:55 share/doc/buildg-full/README.md
-rw-r--r-- 0/0             508 2022-09-05 09:55 share/doc/buildg-full/SHA256SUMS

---

The sha256sum of SHA256SUM is b2a291eb3686cec66fdf5cc830ecbb08f56c3f23f164cd3e2b751cfce7135622

v0.4.0

Notable Changes

Rootless without shellscript(buildg.sh) (#72)

Now buildg can run in rootless mode without shellscript(buildg.sh).

$ buildg debug /path/to/context

Buildg still depends on RootlessKit and slirp4netns on your host.

DAP configurations (examples/dap/nvim/plugins.lua and examples/dap/emacs/dap-dockerfile.el) have also been updated not to use buildg.sh but directly use buildg command.

Release full binary tarball (#76)

For easier installation of buildg, our release artifact starts containing binary dependencies (runc, rootlesskit and slirp4netns) in a single tar (discussed later).

Containerized buildg (#47, #59), thanks to @developer-guy

This release start to distribute containerized buildg on ghcr.io/ktock/buildg.

$ docker run --rm -it --privileged -v /path/to/ctx:/ctx:ro ghcr.io/ktock/buildg:0.4.0 debug /ctx

You can also build this container image on the buildg repo.

$ docker build -t buildg .
$ docker run --rm -it --privileged -v /path/to/ctx:/ctx:ro buildg debug /ctx

Other notable changes

• Allow launching shell on an arbitrary instruction (#54)
• Enable cache reuse feature by default (#62)
• Add reload command to reload and restart Dockerfile (#74)
• Add log command to show buildg logs (#71)
• Allow to specify the target breakpoint on continue (#75)
• Add --version flag (#73)
• Statically link buildg binary (#57)
• DAP: update documents and example configurations of IDEs(#43, #48, #50, #80)

About the binaries

• Minimal(e.g. buildg-v0.4.0-linux-amd64.tar.gz): contains only buildg binary
• Full(e.g. buildg-full-v0.4.0-linux-amd64.tar.gz): contains buildg and its dependencies

Minimal

Extract it to a path like /usr/local/bin/ or ~/bin/

list of files

-rwxr-xr-x root/root  23724032 2022-09-05 08:53 buildg

Full

Extract it to a path like /usr/local/ or ~/.local

list of files

drwxr-xr-x 0/0               0 2022-09-05 08:56 bin/
-rwxr-xr-x 0/0        23916544 2022-09-05 08:56 bin/buildg
-rwxr-xr-x 0/0         9443526 2022-05-02 08:24 bin/rootlessctl
-rwxr-xr-x 0/0        10879193 2022-05-02 08:24 bin/rootlesskit
-rwxr-xr-x 0/0        13733640 2022-09-05 08:56 bin/runc
-rwxr-xr-x 0/0         2338128 2022-09-05 08:56 bin/slirp4netns
drwxr-xr-x 0/0               0 2022-09-05 08:56 share/
drwxr-xr-x 0/0               0 2022-09-05 08:56 share/doc/
drwxr-xr-x 0/0               0 2022-09-05 08:56 share/doc/buildg-full/
-rw-r--r-- 0/0             329 2022-09-05 08:56 share/doc/buildg-full/README.md
-rw-r--r-- 0/0             508 2022-09-05 08:56 share/doc/buildg-full/SHA256SUMS

---

The sha256sum of SHA256SUM is 9a6ba435ab420e0b19b1e242f8bf8eb835a8cb1f631deb7bf0a9e10671d42637

v0.3.0

This release contains initial support for DAP (Debug Adapter Protocol). This allows visual and interactive debugging of Dockerfiles on IDEs supporting DAP (e.g. VS Code, Emacs, Neovim).

See ./examples/dap for details.

Notable Changes

• Initial support of DAP (Debug Adapter Protocol) (#42)
• Support importing external cache. One of the use-cases is to inspect the remotely cached build emitted from the remotely performed build (e.g. on Kubernetes). See docs/cache-from.md for details and the example. (#36)
• Support overlayfs snapshotter (#38)
• Fix panic bugs (#40, #41)

v0.2.0

Now instructions cached by --cache-reuse experimental flag supports breakpoints. You can use this flag to reuse cached instructions and make 2nd-time debugging faster.

Notable Changes

• Allow breakpoints on cached instructions (#33)
• Added prune and du subcommands (#34)
• Move worker flags (--rootless, --oci-*) to global (#34)
• added --env and --workdir flags to exec command (#29)
• docs(README): fix typo (#7), thanks to @developer-guy
• decrease error verbosity (#27), thanks to @fahedouch

v0.1.1

Notable Changes

• Allow buildg reusing cached build results among invocation (#24)
• ls: Allow specifying the range of lines to print (#25)
• docs: Add doc about that nerdctl provides buildg as a subcommand (#26)

v0.1.0

Notable Changes

• The debug session now supports shell-styled quoting and escaping (#16)
• Added support for mount=type=ssh|secret (#17)
• Now supports breakpoints on any instructions (exec is allowed only on RUN as of now) (#21)
• UI improvement (#19, #20, #23)

v0.0.3

Notable Changes

• Improved command reference to README (#14)
• Introduced structured command parser (#13, #15)
• CI: Added tests (#13)