CHANGELOG.md

Changelog

0.23.0 (2026-03-16)

Build System or External Dependencies

• deps: bump go.opentelemetry.io/otel/sdk from 1.39.0 to 1.40.0 (#417) (e0f86fe)

Features

• add GET /images/{name}/get export endpoint (#413) (3d7d449)

Bug Fixes

• include filtered containers in network inspect (b75d116)
• include filtered containers in network inspect response (#412) (b75d116)
• remove samcli-vm workflow and stabilize direct testing (dbd821f)
• remove samcli-vm workflow and stabilize direct testing (#414) (dbd821f)
• simplify network calls to nerdctl (#397) (f3fe743)

0.22.0 (2026-01-14)

Features

• add containers field in network inspect response (#384) (356ed67)

Bug Fixes

• add grace period to allow registry to start up (#393) (0847813)
• ci: fix Python version and timeout of SAM CLI workflows (#383) (c7c8fec)

0.21.0 (2025-12-24)

Build System or External Dependencies

• deps: bump github.com/containerd/containerd/v2 (a7c990f)
• deps: bump github.com/containerd/containerd/v2 from 2.1.4 to 2.1.5 (#361) (a7c990f)
• deps: bump github.com/containernetworking/plugins (b2d30ca)
• deps: bump github.com/containernetworking/plugins from 1.7.1 to 1.9.0 (#365) (b2d30ca)
• deps: bump github.com/onsi/gomega from 1.38.1 to 1.38.3 (#371) (62f744e)
• deps: bump github.com/open-policy-agent/opa from 1.7.1 to 1.12.1 (#370) (e56548b)
• deps: bump github.com/stretchr/testify from 1.10.0 to 1.11.1 (#326) (762b18c)
• deps: bump golang.org/x/crypto from 0.41.0 to 0.45.0 (#363) (6282e66)

Features

• add HostConfig to container inspect response (#324) (7148cd8)

Bug Fixes

• ci: fix finch daemon macos vm test workflow (#364) (fb371ad)
• Cleanup finch yaml before tests (#367) (67339ac)

0.20.0 (2025-08-24)

Build System or External Dependencies

• deps: Bump github.com/containerd/containerd/v2 (e0bf796)
• deps: Bump github.com/containerd/containerd/v2 from 2.1.3 to 2.1.4 (#298) (e0bf796)
• deps: Bump github.com/containerd/go-cni from 1.1.12 to 1.1.13 (#310) (8fc5617)
• deps: Bump github.com/docker/cli (b332913)
• deps: Bump github.com/docker/cli from 28.3.2+incompatible to 28.3.3+incompatible (#295) (b332913)
• deps: Bump github.com/docker/docker (d781e7a)
• deps: Bump github.com/docker/docker from 28.3.2+incompatible to 28.3.3+incompatible (#291) (d781e7a)
• deps: bump github.com/go-viper/mapstructure/v2 (bc87ea3)
• deps: bump github.com/go-viper/mapstructure/v2 from 2.3.0 to 2.4.0 (#316) (bc87ea3)
• deps: Bump github.com/moby/moby (e83ee35)
• deps: Bump github.com/moby/moby from 28.3.2+incompatible to 28.3.3+incompatible (#294) (e83ee35)
• deps: Bump github.com/onsi/ginkgo/v2 from 2.23.4 to 2.25.1 (#317) (a1593ab)
• deps: Bump github.com/open-policy-agent/opa from 1.6.0 to 1.7.1 (#299) (0565571)
• deps: Bump golang.org/x/net from 0.42.0 to 0.43.0 (#302) (6fc924a)
• deps: Bump golang.org/x/sys from 0.34.0 to 0.35.0 (#308) (0d49824)
• deps: bump google.golang.org/protobuf from 1.36.6 to 1.36.8 (#315) (689c09e)

Features

• Add container top support (#204) (922fe22)
• add finch vm testing (4cbe576)
• Upgrade nerdctl to 2.1.3 and handle backward compatiblilty issues (#293) (61ce02b)

Bug Fixes

• container stat test flakiness (#303) (68703a4)

0.19.1 (2025-07-28)

Bug Fixes

• downgrade nerdctl from v2.1.3 to v2.1.2 (#289) (a7487bf)

0.19.0 (2025-07-17)

Features

• Use nerdctl parsing logic for port publishing (#265) (1aec7ce)

Bug Fixes

• restore update network settings for dockercompat (#286) (8fc3a1e)

0.18.1 (2025-07-11)

Bug Fixes

• verify release artifact (20dc067)
• verify release artifact docker-credential-finch (#284) (20dc067)

0.18.0 (2025-07-11)

Build System or External Dependencies

• deps: Bump github.com/docker/docker from 28.0.2+incompatible to 28.2.2+incompatible (#251) (097fb7e)
• deps: Bump github.com/go-viper/mapstructure/v2 (0e28455)
• deps: Bump github.com/go-viper/mapstructure/v2 from 2.2.1 to 2.3.0 (#273) (0e28455)
• deps: Bump github.com/open-policy-agent/opa from 1.1.0 to 1.4.0 (#268) (7ec7d02)

Features

• Add credential management for container build (#275) (47d2a65)
• migrate from golang gomock to uber gomock (#264) (bb9442a)
• Opa middleware support (Experimental) (#156) (91b9ac6)

0.17.2 (2025-06-06)

Build System or External Dependencies

• deps: Bump github.com/containerd/containerd/api (439fd61)
• deps: Bump github.com/containerd/containerd/api from 1.8.0 to 1.9.0 (#245) (439fd61)
• deps: Bump github.com/docker/cli (350ae05)
• deps: Bump github.com/docker/cli from 28.0.4+incompatible to 28.2.2+incompatible (#248) (350ae05)

Bug Fixes

• skip blkio test in vm (#256) (7020f93)

0.17.1 (2025-06-06)

Bug Fixes

• Update blkio tests to be compatible with finch CI (#252) (1d672cd)

0.17.0 (2025-06-04)

Build System or External Dependencies

• deps: Bump github.com/containernetworking/cni from 1.2.3 to 1.3.0 (#214) (253b7eb)
• deps: Bump golang.org/x/sys from 0.32.0 to 0.33.0 (#242) (e706101)

Features

• Add annotations option (#238) (23fd05e)
• Add Blkio related options (#229) (8dc97f8)
• Add cgroupnsmode option (#237) (831e2a2)
• Add devices option (#236) (4198dcc)
• Add PidMode, Ipc mode (dde482c)
• Add PidMode, Ipcmode and GroupAdd options (#232) (dde482c)
• Add ReadonlyRootfs option (#233) (82b0ff4)
• Add ShmSize, Sysctl and Runtime option (#235) (c4fc1c9)
• add signal option to containerStop (#158) (abfa7f7)
• Add VolumesFrom, Tmpfs and UTSMode option (#231) (18434d7)

Bug Fixes

• handleNetworkLabels failing after nerdctl v2.0.0 upgrade (#249) (06bc4fd)

0.16.0 (2025-05-13)

Build System or External Dependencies

• deps: Bump github.com/moby/moby (c683e9c)
• deps: Bump github.com/moby/moby from 28.0.1+incompatible to 28.1.1+incompatible (#221) (c683e9c)
• deps: Bump github.com/onsi/gomega from 1.36.3 to 1.37.0 (#216) (c1b516e)
• deps: Bump github.com/pelletier/go-toml/v2 from 2.2.3 to 2.2.4 (#215) (6c55ee6)
• deps: Bump github.com/runfinch/common-tests from 0.9.2 to 0.9.4 (#239) (3cfd4a0)
• deps: Bump google.golang.org/protobuf from 1.36.5 to 1.36.6 (#213) (8943984)

Features

• Add Cpu options and missing tests to cidfile option (#230) (669a0ee)
• Add OomKillDisabled, NetworkDisabled and MACAddress option (#228) (58eef04)
• Add unpause container support (#192) (460b73f)

0.15.0 (2025-04-10)

Build System or External Dependencies

• deps: Bump github.com/containerd/nerdctl/v2 from 2.0.3 to 2.0.4 (#207) (f285fcd)
• deps: Bump github.com/docker/cli (a00d384)
• deps: Bump github.com/docker/cli from 27.5.0+incompatible to 28.0.4+incompatible (#202) (a00d384)
• deps: Bump github.com/onsi/ginkgo/v2 from 2.22.2 to 2.23.4 (#209) (9ef5131)
• deps: Bump github.com/opencontainers/runtime-spec (9d4de73)
• deps: Bump github.com/opencontainers/runtime-spec from 1.2.0 to 1.2.1 (#188) (9d4de73)
• deps: Bump github.com/runfinch/common-tests from 0.9.1 to 0.9.2 (#205) (e5cef2a)
• deps: Bump github.com/spf13/afero from 1.12.0 to 1.14.0 (#191) (3dffcbb)
• deps: Bump github.com/spf13/cobra from 1.8.1 to 1.9.1 (#189) (06b6922)
• deps: Bump golang.org/x/net from 0.37.0 to 0.39.0 (#210) (e22380f)

Features

• add additional options to image build (#152) (49cdd07)
• Add pause container support (#185) (9aa41bf)

Bug Fixes

• Tag mockgen and stringer packages for gen-code make target (#193) (3db64f9)

0.14.0 (2025-03-18)

Build System or External Dependencies

• deps: Bump github.com/containerd/containerd/v2 from 2.0.2 to 2.0.4 (#186) (8d92e1f)
• deps: Bump github.com/containerd/go-cni from 1.1.11 to 1.1.12 (#154) (d9be44f)
• deps: bump github.com/containerd/nerdctl/v2 from 2.0.0 to 2.0.3 (#173) (1bcfebd)
• deps: Bump github.com/docker/docker from 27.5.0+incompatible to 28.0.1+incompatible (#170) (e474488)
• deps: Bump github.com/go-jose/go-jose/v4 from 4.0.4 to 4.0.5 (#167) (71a062a)
• deps: Bump github.com/moby/moby from 27.4.1+incompatible to 28.0.1+incompatible (#169) (be4b61a)
• deps: Bump golang.org/x/net from 0.34.0 to 0.36.0 (#182) (006c68d)
• deps: Bump golang.org/x/net from 0.34.0 to 0.37.0 (#183) (159c5f3)
• deps: Bump google.golang.org/protobuf from 1.36.4 to 1.36.5 (#184) (46b1402)

Features

• add detachKeys option to container start (#159) (b03f126)

Bug Fixes

• Refactor filters parsing (#181) (6d36c03)
• refactor wait API (#177) (08878dc)

0.13.1 (2025-02-21)

Bug Fixes

• update create-releases.sh (#165) (1edf2d4)

0.13.0 (2025-02-18)

Build System or External Dependencies

• deps: Bump github.com/onsi/ginkgo/v2 from 2.22.1 to 2.22.2 (#138) (776946b)
• deps: Bump github.com/runfinch/common-tests from 0.8.0 to 0.9.1 (#140) (96b109e)
• deps: Bump github.com/spf13/afero from 1.11.0 to 1.12.0 (#150) (db169fb)
• deps: Bump golang.org/x/net from 0.33.0 to 0.34.0 (#141) (5b1fe1c)
• deps: Bump google.golang.org/protobuf from 1.36.1 to 1.36.4 (#151) (f7c7b30)

Features

• Add container kill API (#146) (8a40617)
• Update container inspect with size option (#157) (b5df6ef)

Others

• Update containerd and nerdctl to v2 (#148) (d3db35e)

0.12.0 (2024-12-27)

Build System or External Dependencies

• deps: Bump github.com/containerd/cgroups/v3 from 3.0.3 to 3.0.5 (#130) (bc69841)
• deps: Bump github.com/containerd/go-cni from 1.1.10 to 1.1.11 (#134) (82f9629)
• deps: Bump github.com/containerd/typeurl/v2 from 2.2.0 to 2.2.3 (#133) (d9704ff)
• deps: Bump github.com/docker/cli from 26.0.0+incompatible to 27.4.1+incompatible (#125) (bff4a1f)
• deps: Bump github.com/docker/docker from 26.1.5+incompatible to 27.4.1+incompatible (#127) (f77066d)
• deps: Bump github.com/moby/moby from 26.0.0+incompatible to 27.4.1+incompatible (#132) (da5f7cd)
• deps: Bump github.com/onsi/ginkgo/v2 from 2.20.2 to 2.22.1 (#129) (606c16b)
• deps: Bump github.com/onsi/gomega from 1.36.1 to 1.36.2 (#136) (72facd2)
• deps: Bump github.com/vishvananda/netns from 0.0.4 to 0.0.5 (#112) (40d3991)
• deps: Bump golang.org/x/crypto from 0.29.0 to 0.31.0 (#120) (5c99f3e)
• deps: Bump google.golang.org/protobuf from 1.35.1 to 1.35.2 (#116) (682d4cd)
• deps: Bump google.golang.org/protobuf from 1.35.2 to 1.36.0 (#128) (b46d499)

Features

• add distribution API (with bug fix) (#121) (da0dab7)
• add more options to container create API (#122) (9fda9cd)

Bug Fixes

• Update go mod to fix CVE-2024-45338 (#124) (19a3980)

0.11.0 (2024-11-27)

Build System or External Dependencies

• deps: Bump github.com/containernetworking/cni from 1.2.2 to 1.2.3 (#87) (46df1b6)
• deps: Bump github.com/coreos/go-iptables from 0.7.0 to 0.8.0 (#106) (9905569)
• deps: Bump github.com/stretchr/testify from 1.9.0 to 1.10.0 (#107) (e5b9878)
• deps: Bump golang.org/x/net from 0.29.0 to 0.31.0 (#93) (dcffe39)
• deps: Bump github.com/containerd/containerd from 1.7.22 to 1.7.24 (#102) (0d6cd12)
• deps: Bump github.com/containerd/errdefs from 0.1.0 to 1.0.0 (#102) (0d6cd12)

Features

• Implementation of enable_icc option (#69) (5fd2e3e)

Bug Fixes

• Make DOCKER_CONFIG available to buildctl (#94) (f5b426d)
• Pidfile handling and socket docs (#101) (5c2e99f)
• return an error if custom bridge name is not set successfully (#100) (0469999)

0.10.0 (2024-10-31)

Build System or External Dependencies

• deps: bump github.com/containerd/nerdctl from 1.7.5 to 1.7.7 (#66) (80fdae9)
• deps: bump github.com/runfinch/common-tests from 0.7.21 to 0.8.0 (#64) (df9f0ca)

Features

• Add Support for Extra Hosts (#85) (5722300)
• Add support for nerdctl config and default variables (#73) (284c73f)
• Add support for pidfile (#90) (55eacb5)
• Add support for socket Activation (#89) (d185ad3)

Bug Fixes

• Add static binaries to release (#63) (57a0c44)
• bump minor for feat (65fbf5a)
• Remove bump-patch-for-minor-pre-major (#83) (65fbf5a)

0.9.0 Finch-Daemon Init

This is the first release of the Finch Daemon. The Finch Daemon project is an open source container runtime engine that enables users to integrate software that uses Docker's RESTful APIs as a programmatic dependency.