# Install neonctl with Homebrew, apk, dnf, MacPorts, Nix, pacman, zypper Neon CLI tool. Version 2.30.1 via Homebrew; verified 2026-07-05. ## Install ```sh sudo av install brew:neonctl ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install neonctl ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install neon ``` Evidence: MacPorts ports tree: www/neon/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add neon ``` Evidence: Alpine Linux edge package indexes: neon from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz - dnf (92%): ```sh sudo dnf install neon ``` Evidence: Fedora Rawhide package metadata: neon from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst - Nix (92%): ```sh nix profile install nixpkgs#neon ``` Evidence: nixpkgs package indexes: pkgs/by-name/ne/neon/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - pacman (92%): ```sh sudo pacman -S neon ``` Evidence: Arch Linux sync databases: neon from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz - zypper (92%): ```sh sudo zypper install libneon-devel ``` Evidence: openSUSE Tumbleweed package metadata: libneon-devel from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ## Package facts - **Package key:** brew:neonctl - **Package manager:** Homebrew - **Package manager page:** - **Version:** 2.30.1 - **Source summary:** Neon CLI tool - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** Apache-2.0 - **Source archive:** - **Last updated:** 2026-07-05T09:29:36Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - neon (cli) - neonctl (cli) - neon (alias) - neonctl (alias) ## Dependencies - esbuild - node ## Install behavior - Post-install hook: not defined - Bottle: available on all ## Freshness - Page generated: 2026-07-08 - Package-manager version: 2.30.1 - Package-manager updated: 2026-07-05 - Local data: ok - Upstream repository: https://neon.tech/docs/reference/neon-cli - info: Release/tag comparison is only available for GitHub repositories. ## Project history and usage neonctl is Neon's command-line client for Neon Serverless Postgres. It is packaged in Homebrew as `neonctl`, published for npm users, and exposes both `neonctl` and, in the newer monorepo package, the shorter `neon` command for managing Neon projects from a terminal. ### Project history The standalone `neondatabase/neonctl` repository was created on 2022-08-27 and was later archived after development moved to the `neondatabase/neon-pkgs` monorepo under `packages/cli`. The old README points users to the monorepo for issues and pull requests, so the package history is a migration story rather than a dead project story. The npm package `neonctl` was created on 2022-08-17 and had 172 published versions by 2026-07-01, while the newer monorepo release tags use names such as `neonctl@2.29.2`. That release cadence fits a cloud-service CLI: frequent small updates track API, authentication, branch, and deployment-surface changes. ### Adoption history Homebrew's formula API listed `neonctl` stable 2.29.0 on 2026-07-01, with install analytics of 1,704 installs in 30 days, 2,502 in 90 days, and 9,571 in 365 days. That is modest compared with editor/toolchain packages, but meaningful for a vendor-specific database CLI. Adoption is tied to Neon users rather than to a broad independent ecosystem. The package matters when teams use Neon branching, connection strings, API-key automation, or local project linking from shell scripts and CI. ### How it is used The documented install paths are npm, Homebrew, and direct binaries. Users authenticate with `neon auth` or `neonctl auth`, list and create projects or branches, fetch connection strings, open `psql`, and bind a working directory to a Neon project with `link`-style workflows. Package-oriented users tend to install it globally through Homebrew or npm because it is an operational tool: it belongs on developer laptops and CI runners rather than inside an application dependency graph. ### Why package nerds care For av.db, `brew:neonctl` is best treated as a cloud database control-plane CLI with active upstream development in a moved repository. The Homebrew formula name preserves the older `neonctl` identity even as the command and npm package story shifts toward `neon`. ### Timeline - {'date': '2022-08-17', 'event': 'The `neonctl` npm package was created.'} - {'date': '2022-08-27', 'event': 'The standalone `neondatabase/neonctl` GitHub repository was created.'} - {'date': '2025-04-09', 'event': 'The `neondatabase/neon-pkgs` monorepo was created.'} - {'date': '2026-07-01', 'event': 'The `neon-pkgs` releases page listed `neonctl@2.29.2`; Homebrew listed stable 2.29.0.'} ### Related projects - Neon Serverless Postgres - neondatabase/neon-pkgs - neondatabase/neonctl ### Sources - - - - - - - ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## Configuration and credential file locations These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval. ## Configuration files - Unix: .neon, neon.ts ## Credential files - Unix: ~/.config/neonctl/credentials.json ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** neonctl - **Version Scheme:** 0 - **Revision:** 0 - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** stable ## Other Package-Manager Records - MacPorts - neon: installed executable or alias match | MacPorts ports tree: www/neon/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - Nix - neon: installed executable or alias match | nixpkgs package indexes: pkgs/by-name/ne/neon/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - apk - neon - 0.36.0-r0: installed executable or alias match | Alpine Linux edge package indexes: neon from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | HTTP and WebDAV client library with a C interface | https://notroj.github.io/neon/ - apk - neon-dev - 0.36.0-r0: installed executable or alias match | Alpine Linux edge package indexes: neon-dev from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | HTTP and WebDAV client library with a C interface (development files) | https://notroj.github.io/neon/ - apk - neon-doc - 0.36.0-r0: installed executable or alias match | Alpine Linux edge package indexes: neon-doc from https://dl-cdn.alpinelinux.org/alpine/edge/main/x86_64/APKINDEX.tar.gz | HTTP and WebDAV client library with a C interface (documentation) | https://notroj.github.io/neon/ - dnf - neon - 0.37.1-1.fc45: installed executable or alias match | Fedora Rawhide package metadata: neon from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | An HTTP and WebDAV client library | https://notroj.github.io/neon/ - dnf - neon-devel - 0.37.1-1.fc45: installed executable or alias match | Fedora Rawhide package metadata: neon-devel from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Development libraries and C header files for the neon library | https://notroj.github.io/neon/ - pacman - neon - 0.37.1-1: installed executable or alias match | Arch Linux sync databases: neon from https://geo.mirror.pkgbuild.com/extra/os/x86_64/extra.db.tar.gz | HTTP/1.1 and WebDAV client library | https://notroj.github.io/neon/ - zypper - libneon-devel - 0.37.1-1.2: installed executable or alias match | openSUSE Tumbleweed package metadata: libneon-devel from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | An HTTP and WebDAV Client Library | https://notroj.github.io/neon/ - zypper - libneon27 - 0.37.1-1.2: installed executable or alias match | openSUSE Tumbleweed package metadata: libneon27 from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | An HTTP and WebDAV Client Library | https://notroj.github.io/neon/ - zypper - libneon27-32bit - 0.37.1-1.2: installed executable or alias match | openSUSE Tumbleweed package metadata: libneon27-32bit from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | An HTTP and WebDAV Client Library | https://notroj.github.io/neon/ ## Related links - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata. - [Developer build packages](https://www.automicvault.com/pkg/developer-build-tools/) - Matched build, compiler, generator, or developer workflow metadata. - [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata. - [esbuild](https://www.automicvault.com/pkg/brew/esbuild/) - Runtime dependency declared by Homebrew. - [node](https://www.automicvault.com/pkg/brew/node/) - Runtime dependency declared by Homebrew. - [dbhash](https://www.automicvault.com/pkg/brew/dbhash/) - Shares av.db curated category or tags: cli, database, developer-tools. - [sqlcmd](https://www.automicvault.com/pkg/brew/sqlcmd/) - Shares av.db curated category or tags: cli, database, developer-tools. - [litecli](https://www.automicvault.com/pkg/brew/litecli/) - Shares av.db curated category or tags: cli, database, developer-tools. - [mongosh](https://www.automicvault.com/pkg/brew/mongosh/) - Shares av.db curated category or tags: cli, database, developer-tools. - [chdig](https://www.automicvault.com/pkg/brew/chdig/) - Shares av.db curated category or tags: cli, database, developer-tools. - [diesel](https://www.automicvault.com/pkg/brew/diesel/) - Shares av.db curated category or tags: cli, database, developer-tools. - [eralchemy](https://www.automicvault.com/pkg/brew/eralchemy/) - Shares av.db curated category or tags: cli, database, developer-tools. - [golang-migrate](https://www.automicvault.com/pkg/brew/golang-migrate/) - Shares av.db curated category or tags: cli, database, developer-tools. - [neonctl](https://www.automicvault.com/pkg/npm/neonctl/) - Same normalized package name appears in another local ecosystem. Shared terms: neon, neonctl, node. - [supabase](https://www.automicvault.com/pkg/brew/supabase/) - Both packages touch the same language runtime or ecosystem. Shared terms: cli, database, developer, developer-tools, node. - [neonctl](https://www.automicvault.com/pkg/npm/neonctl/) - Same normalized package name in another local ecosystem. ## Combined YAML source View the package source record on GitHub. [combined/neonctl.yml](https://github.com/automic-vault/db/blob/main/combined/neonctl.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph