Skip to content

Finch Release Notes

Finch contributors ยท Open-source command-line client for building, running and publishing Linux containers using nerdctl, containerd, BuildKit and Lima.

CaskVirtualization & Containersย 4.1K
Install command
brew install --cask finch
30-day installs
243
#613 in App
1-year installs
3.4K
Last 365 days
Latest version
1.19.0
Download size
513MB
pkg
Release cadence
Irregular
0 releases in 30 days
  1. 1.19.0

    Latest

    OpenNavo editorial Added to Homebrew

    Warns that the Finch VM is not a security boundary, restores the macOS keychain helper path, and updates containerd and gRPC.

    Release
    See the full official changelog below for exact changes.

    1.19.0 (2026-09-16)

    Build System or External Dependencies

    • deps: bump github.com/containerd/containerd/v2 (350e80b)
    • deps: bump github.com/containerd/containerd/v2 from 2.2.5 to 2.2.8 (#1809) (350e80b)
    • deps: bump google.golang.org/grpc from 1.81.1 to 1.83.1 (#1805) (07d4117)

    Features

    • warn that Finch VM is not a security boundary on vm init (#1808) (ef69290)

    Bug Fixes

    • move docker-credential-osxkeychain back to /usr/local/bin (#1803) (8065f30)

    Source: https://github.com/runfinch/finch/releases/tag/v1.19.0

  2. 1.18.0

    GitHub Release

    1.18.0 (2026-08-20)

    Build System or External Dependencies

    • deps: bump golang.org/x/image from 0.38.0 to 0.41.0 (#1782) (ab0df60)
    • deps: Bump submodules and dependencies (#1783) (2b40269)
    • deps: Bump submodules and dependencies (#1797) (b8b46a5)

    Features

    • add auto vm init/start on first finch run (#1751) (48c9a8b)
    • gate vmnet behind config, use vzNAT for vz and socket_vmnet for qemu (ff1346b)
    • use vzNAT for vz networking, gate socket_vmnet behind config for qemu (#1749) (ff1346b)

    Bug Fixes


  3. 1.17.2

    Patch

    OpenNavo editorial Added to Homebrew

    Updates containerd, Docker CLI, OpenTelemetry and other dependencies, and adjusts a CI runner reference for SAM CLI cleanup.

    Release
    See the full official changelog below for exact changes.

    1.17.2 (2026-06-30)

    Build System or External Dependencies

    • deps: bump github.com/containerd/containerd/v2 (1b328cd)
    • deps: bump github.com/containerd/containerd/v2 (c2025af)
    • deps: bump github.com/containerd/containerd/v2 from 2.2.1 to 2.2.4 (#1746) (c2025af)
    • deps: bump github.com/containerd/containerd/v2 from 2.2.4 to 2.2.5 (#1763) (1b328cd)
    • deps: bump github.com/docker/cli (73676d5)
    • deps: bump github.com/docker/cli from 29.2.0+incompatible to 29.5.3+incompatible in the docker group across 1 directory (#1667) (73676d5)
    • deps: bump github.com/docker/cli from 29.5.3+incompatible to 29.6.0+incompatible in the docker group (#1764) (979aad8)
    • deps: bump github.com/docker/cli in the docker group (979aad8)
    • deps: bump go.opentelemetry.io/otel from 1.39.0 to 1.41.0 (#1741) (b55aa37)
    • deps: Bump submodules and dependencies (#1766) (f862071)
    • deps: bump the project-dependency group across 1 directory with 11 updates (#1770) (9260387)
    • deps: golang.org/x/net from v0.54.0 to v0.55.0 (#1756) (e2c5d05)

    Bug Fixes

    • ci: update codebuild runner ref for samcli cleanup step (#1753) (8615eb9)

    Source: https://github.com/runfinch/finch/releases/tag/v1.17.2

  4. 1.17.1

    Expand

    OpenNavo editorial Added to Homebrew

    Updates submodules and dependencies and fixes SAM CLI invoke tests for ARM64 CI runners.

    Release
    See the full official changelog below for exact changes.

    1.17.1 (2026-05-29)

    Build System or External Dependencies

    Bug Fixes

    • ci: Fix samcli-vm invoke tests for ARM64 runners (9b0ce05)
    • troubleshoot and patch samcli invoke tests (#1721) (9b0ce05)

    Source: https://github.com/runfinch/finch/releases/tag/v1.17.1

  5. 1.17.0

    Expand

    GitHub Release Added to Homebrew

    1.17.0 (2026-04-24)

    Build System or External Dependencies

    • deps: bump github.com/containerd/nerdctl/v2 from 2.2.1 to 2.2.2 (#1736) (d561171)
    • deps: bump github.com/docker/cli (8b0ac64)
    • deps: bump github.com/docker/cli from 29.1.3+incompatible to 29.2.0+incompatible (#1714) (8b0ac64)
    • deps: bump github.com/go-jose/go-jose/v4 from 4.1.3 to 4.1.4 (#1732) (802ce82)
    • deps: bump golang.org/x/image from 0.18.0 to 0.38.0 (#1731) (05a28ee)
    • deps: bump google.golang.org/grpc from 1.78.0 to 1.79.3 (#1725) (2d36408)
    • deps: Bump submodules and dependencies (#1728) (80958a6)

    Features


  6. 1.16.0

    Expand

    GitHub Release Added to Homebrew

    1.16.0 (2026-03-19)

    Please note:


    Build System or External Dependencies

    • deps: Bump submodules and dependencies (#1708) (b6ba659)
    • deps: update Lima to v2.1
    • deps: update Cosign to v3.0.5
    • deps: update Finch Daemon to v0.23.0

    Features

    • add Amazon Linux 2023 based OS images built with MKOSI (#1716) (40e5350)

    Bug Fixes


  7. 1.15.0

    Expand

    GitHub Release Added to Homebrew

    1.15.0 (2026-02-19)

    Build System or External Dependencies

    Features

    Bug Fixes

    • generate date-agnostic gzip files (#1676) (4e3d3fa)
    • improve logging for Finch pkg (#1697) (af2d97e)
    • increase timeout for aws creds for signing (#1689) (e8c54b9)
    • remove multiple cp commands that overwrites older installers (#1681) (2c26c9b)
    • reschedule nightly (#1691) (8346549)
    • Set mirrored network mode for wsl host to vm networking test in โ€ฆ (#1688) (b8fefdb)

  8. 1.14.0

    Expand

    GitHub Release

    1.14.0 (2026-01-12)

    Build System or External Dependencies

    • deps: bump github.com/aws/aws-sdk-go-v2 from 1.39.0 to 1.39.4 (#1606) (9b536ba)
    • deps: bump github.com/containerd/containerd/v2 (b537d8c)
    • deps: bump github.com/containerd/containerd/v2 from 2.1.4 to 2.1.5 (#1618) (b537d8c)
    • deps: bump github.com/containernetworking/plugins (b7e4eec)
    • deps: bump github.com/containernetworking/plugins from 1.8.0 to 1.9.0 (#1636) (b7e4eec)
    • deps: bump github.com/onsi/ginkgo/v2 from 2.25.3 to 2.27.2 (#1610) (17341ab)
    • deps: bump golang.org/x/crypto from 0.42.0 to 0.45.0 (#1627) (32261b2)
    • deps: Bump submodules and dependencies (#1623) (c364e2a)
    • deps: Bump submodules and dependencies (#1631) (4b339e4)
    • deps: bump the project-dependency group with 12 updates (#1646) (b658c43)

    Features

    Bug Fixes


  9. 1.12.0

    Expand

    GitHub Release Added to Homebrew

    1.12.0 (2025-10-22)

    Build System or External Dependencies

    • deps: bump github.com/aws/aws-sdk-go-v2 from 1.38.3 to 1.39.0 (#1552) (0a3a2b2)
    • deps: bump github.com/spf13/afero from 1.14.0 to 1.15.0 (#1554) (edb8591)
    • deps: bump github.com/spf13/afero/sftpfs from 1.14.0 to 1.15.0 (#1553) (d1b68a7)
    • deps: bump golang.org/x/tools from 0.36.0 to 0.37.0 (#1557) (f7b25d3)
    • deps: bump k8s.io/apimachinery from 0.34.0 to 0.34.1 (#1556) (836211b)
    • deps: Bump submodules and dependencies (#1565) (32829c6)
    • deps: Bump submodules and dependencies (#1585) (6793e06)
    • deps: Bump submodules and dependencies (#1592) (ab0b93b)

    Features

    • Increase default cpu and memory to 1/2 of system cpu and memory (#1563) (90a9594)

    Bug Fixes


  10. 1.11.0

    Expand

    GitHub Release Added to Homebrew

    1.11.0 (2025-09-08)

    Build System or External Dependencies

    • deps: bump github.com/aws/aws-sdk-go-v2 from 1.36.5 to 1.37.2 (#1494) (94289c9)
    • deps: bump github.com/aws/aws-sdk-go-v2 from 1.37.2 to 1.38.0 (#1510) (9ed1939)
    • deps: bump github.com/aws/aws-sdk-go-v2 from 1.38.0 to 1.38.3 (#1543) (de9049b)
    • deps: bump github.com/lima-vm/lima from 1.1.1 to 1.2.1 (#1486) (5d7676f)
    • deps: bump github.com/onsi/ginkgo/v2 from 2.23.4 to 2.24.0 (#1511) (fbb7c24)
    • deps: bump github.com/onsi/ginkgo/v2 from 2.25.1 to 2.25.3 (#1542) (f693a0d)
    • deps: bump github.com/onsi/gomega from 1.37.0 to 1.38.0 (#1490) (d98d54d)
    • deps: bump github.com/stretchr/testify from 1.10.0 to 1.11.1 (#1541) (c970203)
    • deps: bump golang.org/x/crypto from 0.41.0 to 0.42.0 (#1547) (5f5603d)
    • deps: bump golang.org/x/tools from 0.35.0 to 0.36.0 (#1505) (e9b1d41)
    • deps: bump k8s.io/apimachinery from 0.32.6 to 0.34.0 (#1525) (b7a4c6b)
    • deps: Bump submodules and dependencies (#1526) (94ad970)
    • deps: Bump submodules and dependencies (#1530) (8f073e4)
    • deps: update go 1.24 (#1540) (de1d5e0)

    Features

    • Add finch daemon test for ubuntu and linux (cb91eb9)
    • add finch daemon tests (#1483) (cb91eb9)
    • add force remove test and re-arrange test based on state changes (#1509) (558c80d)
    • add workflow to create pr to update deb dependencies (#1458) (392dd15)
    • optimize vm lifecycle tests (#1508) (fe19eef)

    Bug Fixes

    • ci: Add hardfail to all steps of the .pkg release-installer scipt (#1481) (5695017)
    • downgrade go version to match max AL2 supported version (#1497) (1382eea)
    • fix service file PATH variable (#1520) (7f960bb)
    • remove additional e2e run test (#1528) (beb68ee)
    • unify finch.service files between linux distros (#1496) (893483a)
    • update permission to create pr (#1536) (9277b7d)
  11. 1.10.2

    Expand

    GitHub Release

    1.10.2 (2025-07-31)

    [!NOTE] Release artifacts will not be generated for this release. A follow up release, v1.10.3, including artifacts will be available shortly.

    Build System or External Dependencies

    • deps: bump github.com/docker/cli (9239620)
    • deps: bump github.com/docker/cli from 28.3.0+incompatible to 28.3.3+incompatible (#1478) (9239620)
    • deps: bump github.com/docker/docker (ff3b4a8)
    • deps: bump github.com/docker/docker from 28.3.0+incompatible to 28.3.3+incompatible (#1477) (ff3b4a8)
    • deps: Bump submodules and dependencies (#1482) (664e527)

    Bug Fixes

    • ci: Add error handling for notarization step in release-installer script (#1476) (acf9d02)
    • ci: Added error handling for notarization step (acf9d02)
    • e2e ubuntu workflow should use non-release fleet (#1468) (82b1280)
    • vm: Don't fail if settings match existing one (#1466) (3f680c6)
  12. 1.9.0

    Expand

    GitHub Release Added to Homebrew

    1.9.0 (2025-06-30)

    Build System or External Dependencies

    • deps: Bump github.com/aws/aws-sdk-go-v2 from 1.36.3 to 1.36.5 (#1434) (d6aa084)
    • deps: Bump github.com/docker/cli (8c1611c)
    • deps: Bump github.com/docker/cli from 28.2.2+incompatible to 28.3.0+incompatible (#1439) (8c1611c)
    • deps: Bump github.com/docker/docker (ea432b4)
    • deps: Bump github.com/docker/docker from 28.2.2+incompatible to 28.3.0+incompatible (#1438) (ea432b4)
    • deps: Bump k8s.io/apimachinery from 0.32.4 to 0.33.1 (#1410) (11f8c4d)

    Features

  13. 1.8.3

    Expand

    GitHub Release Added to Homebrew

    1.8.3 (2025-06-10)

    Build System or External Dependencies

    • deps: Bump github.com/docker/cli (8951770)
    • deps: Bump github.com/docker/cli from 28.1.1+incompatible to 28.2.2+incompatible (#1421) (8951770)
    • deps: Bump github.com/docker/docker (bdae3ac)
    • deps: Bump github.com/docker/docker from 28.1.1+incompatible to 28.2.2+incompatible (#1420) (bdae3ac)
    • deps: Bump github.com/lima-vm/lima from 1.0.7 to 1.1.1 (#1415) (95026a1)
    • deps: Bump golang.org/x/crypto from 0.38.0 to 0.39.0 (#1427) (42ac01d)
    • deps: Bump golang.org/x/tools from 0.33.0 to 0.34.0 (#1426) (a423697)
    • deps: Bump submodules and dependencies (#1419) (1b88505)
  14. 1.8.1

    Expand

    GitHub Release Added to Homebrew

    1.8.1 (2025-05-14)

    Build System or External Dependencies

    • deps: Bump github.com/containerd/nerdctl/v2 from 2.0.4 to 2.0.5 (#1387) (8166b1a)
    • deps: Bump github.com/runfinch/common-tests from 0.9.2 to 0.9.4 (#1400) (f83f6e2)
    • deps: Bump golang.org/x/crypto from 0.37.0 to 0.38.0 (#1403) (7b79ed5)
    • deps: Bump golang.org/x/sys from 0.32.0 to 0.33.0 (#1390) (759a616)
    • deps: Bump golang.org/x/text from 0.24.0 to 0.25.0 (#1398) (c1e2093)
    • deps: Bump submodules and dependencies (#1393) (8ff69da)

    Bug Fixes

    Reverts

    • ci(deps): Bump golangci/golangci-lint-action from 7.0.0 to 8.0.0 (#1404) (a542b0d)
  15. 1.8.0

    Expand

    GitHub Release Added to Homebrew

    1.8.0 (2025-05-01)

    Build System or External Dependencies

    • deps: Bump github.com/docker/cli (89ad42b)
    • deps: Bump github.com/docker/cli from 28.0.4+incompatible to 28.1.1+incompatible (#1374) (89ad42b)
    • deps: Bump github.com/docker/docker (a6e1116)
    • deps: Bump github.com/docker/docker from 28.0.4+incompatible to 28.1.1+incompatible (#1373) (a6e1116)
    • deps: Bump k8s.io/apimachinery from 0.32.3 to 0.32.4 (#1379) (471be59)
    • deps: Bump submodules and dependencies (#1375) (6466bcd)
    • deps: Bump submodules and dependencies (#1383) (169b84f)

    Features

    Bug Fixes

  16. 1.7.2

    Expand

    GitHub Release Added to Homebrew

    1.7.2 (2025-04-14)

    Build System or External Dependencies

    • deps: Bump github.com/containerd/nerdctl/v2 from 2.0.3 to 2.0.4 (#1342) (5c34d28)
    • deps: Bump github.com/docker/cli (76d4082)
    • deps: Bump github.com/docker/cli from 28.0.1+incompatible to 28.0.2+incompatible (#1337) (76d4082)
    • deps: Bump github.com/docker/docker and github.com/docker/cli from 28.0.2 to 28.0.4 (#1360) (ab78a0a)
    • deps: Bump github.com/lima-vm/lima from 1.0.5 to 1.0.6 (#1289) (a576086)
    • deps: Bump github.com/lima-vm/lima from 1.0.6 to 1.0.7 (#1350) (106061c)
    • deps: Bump github.com/onsi/ginkgo/v2 from 2.23.2 to 2.23.3 (#1348) (dae86f9)
    • deps: Bump github.com/onsi/ginkgo/v2 from 2.23.3 to 2.23.4 (#1363) (b830ddf)
    • deps: Bump github.com/onsi/gomega from 1.36.2 to 1.37.0 (#1358) (81d8f34)
    • deps: Bump github.com/pkg/sftp from 1.13.8 to 1.13.9 (#1353) (ce14aa7)
    • deps: Bump github.com/runfinch/common-tests from 0.9.1 to 0.9.2 (#1345) (ec5949a)
    • deps: Bump github.com/spf13/afero from 1.12.0 to 1.14.0 (#1343) (a365fc2)
    • deps: Bump golang.org/x/tools from 0.30.0 to 0.31.0 (#1338) (78a89ad)
    • deps: Bump golang.org/x/tools from 0.31.0 to 0.32.0 (#1362) (093e632)
    • deps: Bump k8s.io/apimachinery from 0.31.4 to 0.32.3 (#1319) (9280536)
    • deps: Bump submodules and dependencies (#1346) (a112465)
  17. 1.7.1

    Expand

    GitHub Release Added to Homebrew

    1.7.1 (2025-03-19)

    Build System or External Dependencies

    • deps: Bump github.com/aws/aws-sdk-go-v2 from 1.36.1 to 1.36.2 (#1296) (0ab4f6c)
    • deps: Bump github.com/aws/aws-sdk-go-v2 from 1.36.2 to 1.36.3 (#1307) (2f91a52)
    • deps: Bump github.com/containerd/containerd from 1.7.25 to 1.7.27 (#1328) (33f0368)
    • deps: Bump github.com/containerd/containerd/v2 (eb5e7ad)
    • deps: Bump github.com/containerd/containerd/v2 from 2.0.2 to 2.0.4 (#1327) (eb5e7ad)
    • deps: Bump github.com/docker/cli (f29502a)
    • deps: Bump github.com/docker/cli from 27.5.1+incompatible to 28.0.1+incompatible (#1303) (f29502a)
    • deps: Bump github.com/docker/docker (653eb2f)
    • deps: Bump github.com/docker/docker from 27.5.1+incompatible to 28.0.1+incompatible (#1305) (653eb2f)
    • deps: Bump github.com/go-jose/go-jose/v4 from 4.0.4 to 4.0.5 (#1298) (7b5938f)
    • deps: Bump github.com/onsi/ginkgo/v2 from 2.22.2 to 2.23.0 (#1332) (6b4011f)
    • deps: Bump github.com/spf13/cobra from 1.8.1 to 1.9.1 (#1293) (7314a96)
    • deps: Bump golang.org/x/sync from 0.11.0 to 0.12.0 (#1312) (b77aa58)
    • deps: Bump submodules and dependencies (#1287) (2bc1795)
    • deps: Bump the golang-x group with 3 updates (#1326) (dd66983)