# Finch

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

> This is the Markdown version of the Finch page on OpenNavo, with the same facts as the web page: <https://opennavo.com/apps/finch>

- **Latest version**: `1.19.0`
- **Developer**: Finch contributors
- **Homepage**: <https://github.com/runfinch/finch>
- **Categories**: [Virtualization & Containers](https://opennavo.com/categories/virtualization)
- **Install**: `brew install --cask finch`
- **30-day installs**: 243
- **Homebrew**: Available; updated by Homebrew
- **Download URL**: <https://github.com/runfinch/finch/releases/download/v1.19.0/Finch-v1.19.0-aarch64.pkg>
- **SHA-256**: `bb42aa547c1a99d1e48f68907f02cf04b4186521901d6af185559805eeaf8dd9`
- **Installer packages**: Finch-v1.19.0-aarch64.pkg

SHA-256 only checks that the download is complete; it is not a security certification.

## Installation and removal contents

```json
[
  {
    "declaration": {
      "uninstall": [
        {
          "script": {
            "executable": "/Applications/Finch/uninstall.sh",
            "sudo": true
          }
        }
      ]
    },
    "phase": "uninstall",
    "sources": [],
    "type": "uninstall"
  },
  {
    "declaration": {
      "pkg": [
        "Finch-v1.19.0-aarch64.pkg"
      ]
    },
    "phase": "install",
    "sources": [
      "Finch-v1.19.0-aarch64.pkg"
    ],
    "type": "pkg"
  },
  {
    "declaration": {
      "zap": [
        {
          "trash": "~/.finch"
        }
      ]
    },
    "phase": "cleanup",
    "sources": [],
    "type": "zap"
  }
]
```

## About

Finch is an open-source client for local container development. Its installer provides a native command-line client and an integrated set of open-source components: nerdctl handles build/run/push/pull commands, containerd manages containers, BuildKit builds OCI images, and Lima manages the Linux virtual machine on macOS.

After installation, run `finch vm init` to initialize the environment. The CLI can run containers, build images from Dockerfiles, list images, manage volumes and networks, and use Compose. The `--platform` option supports cross-architecture workloads and builds. A user configuration file at `~/.finch/finch.yaml` controls VM resources and integration options.

Finch is a developer tool, not a production platform or a direct drop-in replacement for every other container tool. Its macOS/Windows VM does not create a security boundary and should not be used to isolate multi-tenant production workloads. This is a CLI installer, not a standalone graphical Mac application.

Sources: [Official repository and setup guide](https://github.com/runfinch/finch), [Official releases](https://github.com/runfinch/finch/releases), [Homebrew cask](https://formulae.brew.sh/cask/finch).

## System requirements

- Build for macOS 27, 26, 15, 14, 13, 12, 11 · Version: 1.19.0 · Intel · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/f/finch.rb> · Checked 2026-11-22
  - <https://github.com/runfinch/finch/releases/download/v1.19.0/Finch-v1.19.0-x86_64.pkg>
  - SHA-256: `62ad25cd694ec1927e871b986df358cc1f12d1abf7904633921e5e284c5474b7`
- Build for macOS 27, 26, 15, 14, 13, 12, 11 · Version: 1.19.0 · Apple silicon · <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/f/finch.rb> · Checked 2026-11-22
  - <https://github.com/runfinch/finch/releases/download/v1.19.0/Finch-v1.19.0-aarch64.pkg>
  - SHA-256: `bb42aa547c1a99d1e48f68907f02cf04b4186521901d6af185559805eeaf8dd9`

## Finch security facts

Only facts that can be checked, each with its source and date. This is not a safety certification. To check the files you downloaded, scan them on your Mac with OpenNavo.

- <https://github.com/runfinch/finch> · Open source: Yes — <https://github.com/runfinch/finch> · Checked 2026-11-14

## Uninstall

- `brew uninstall --cask finch`

A regular uninstall removes the app and keeps its settings and caches.

### Deep clean (optional)

- `brew uninstall --zap --cask finch`

`--zap` also deletes the settings, caches and other files listed in the Homebrew definition. They can include data shared with other apps and cannot be restored, and it does not guarantee that nothing is left. Back up any data you need first. To keep settings and caches, leave out `--zap`.

A regular uninstall removes the app and keeps its settings and caches.

- Files and folders: `~/.finch` — <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/f/finch.rb> · These entries come from the Homebrew definition, checked 2026-11-22. They say what it declares, not what is on your Mac.

## Latest release notes

### 1.19.0 (2026-09-16)

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.

## Facts and sources

- <https://opennavo.com/apps/finch>
- <https://opennavo.com/apps/finch/versions>
- <https://github.com/homebrew/homebrew-cask/blob/HEAD/Casks/f/finch.rb> · Checked 2026-11-22
- <https://formulae.brew.sh/cask/finch>
- <https://github.com/runfinch/finch> · Checked 2026-11-14
