# Install nodenv with Homebrew, Nix

Node.js version manager. Version 1.6.2 via Homebrew; verified from local package data.

## Install

```sh
sudo av install brew:nodenv
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install nodenv
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#nodenv
```

  Evidence: nixpkgs package indexes: pkgs/by-name/no/nodenv/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## Package facts

- **Package key:** brew:nodenv
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/nodenv>
- **Version:** 1.6.2
- **Source summary:** Node.js version manager
- **Homepage:** <https://github.com/nodenv/nodenv>
- **Repository:** <https://github.com/nodenv/nodenv>
- **Upstream docs:** <https://github.com/nodenv/nodenv#readme>
- **License:** MIT
- **Source archive:** <https://github.com/nodenv/nodenv/archive/refs/tags/v1.6.2.tar.gz>
- **Generated:** 2026-07-09T07:20:21+00:00

## Executables

- nodenv (cli)
- nodenv (alias)

## Dependencies

- node-build

## Install behavior

- Post-install hook: not defined
- Bottle: available on all

## Freshness

- Page generated: 2026-07-09
- Package-manager version: 1.6.2
- Local data: ok
- Upstream repository: https://github.com/nodenv/nodenv
- Upstream latest detected: v1.6.2 (current)
- info: No package-manager update timestamp was available.
## Project history and usage

`nodenv` is the rbenv-style Node.js version manager: shims in PATH, per-project `.node-version` files, and Node installations under `~/.nodenv/versions`. It is for developers who want automatic project-local Node selection without shell-function-heavy tools.

### Project history

GitHub metadata shows `nodenv/nodenv` was created on 2013-03-10. Its README credits it as forked from Sam Stephenson's `rbenv` by Will McKenzie and modified for Node.js, which explains the shims, local/global version files, and plugin-driven design.

The companion `nodenv/node-build` repository was created on 2013-03-10 and provides the `nodenv install` command. Its README describes downloading, compiling, and installing Node on Unix-like systems, using precompiled binaries when available and source builds otherwise.

### Adoption history

By 2026-07-01, GitHub metadata reported 2384 stars and 156 forks for `nodenv/nodenv`, plus 294 stars and 85 forks for `nodenv/node-build`. Homebrew's formula API reported stable version 1.6.2 and 11734 installs over 365 days, more than nodebrew and far more than nodeenv in the same Homebrew snapshot.

The README recommends Homebrew on macOS or Linux, and the formula depends on `node-build`. That packaging relationship is part of its adoption: users get the shim manager and the installer plugin as a package-manager-friendly pair.

### How it is used

After `nodenv init`, invocations of `node`, `npm`, `npx`, and related executables pass through nodenv's shims. nodenv scans for `.node-version`, then resolves the requested version under `~/.nodenv/versions`. Common commands are `nodenv install -l`, `nodenv install 24.1.0`, `nodenv local 24.1.0`, `nodenv global 24.1.0`, and `nodenv versions`.

Package nerds use it where `.node-version` is the contract in a repository. The useful detail is precedence and locality: a checked-in `.node-version` makes directory changes switch Node versions automatically, while globally installed npm packages are scoped to the active Node installation.

### Why package nerds care

nodenv matters because it gives Node.js the same operational shape as rbenv and pyenv: shims, local version files, and plugins. That makes it attractive in polyglot developer environments where people already understand the rbenv family.

### Timeline

- 2013-03-10: GitHub repositories `nodenv/nodenv` and `nodenv/node-build` were created.
- 2023-02-18: nodenv v1.4.1 release was published.
- 2024-05-27: nodenv v1.5.0 release was published.
- 2025-07-30: nodenv v1.6.2 release was published.
- 2026-07-01: Homebrew formula API reported stable version 1.6.2.

### Related projects

- rbenv
- node-build
- nodenv-default-packages
- nodenv-package-json-engine
- nvm
- nodebrew

### Sources

- <https://api.github.com/repos/nodenv/node-build>
- <https://api.github.com/repos/nodenv/nodenv>
- <https://formulae.brew.sh/api/formula/nodenv.json>
- <https://github.com/nodenv/node-build>
- <https://github.com/nodenv/nodenv>
- <https://github.com/nodenv/nodenv/releases>
- <https://raw.githubusercontent.com/nodenv/node-build/main/README.md>
- <https://raw.githubusercontent.com/nodenv/nodenv/main/README.md>


## Security Notes

infrastructure mutation or orchestration signal.

- **Geiger risk:** orange / medium
- infrastructure mutation or orchestration signal


## 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: .node-version, ~/.nodenv/version
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** nodenv
- **Version Scheme:** 0
- **Revision:** 0
- **Head Version:** HEAD
- **Bottle Stable Root URL:** <https://ghcr.io/v2/homebrew/core>
- **Deprecated:** no
- **Disabled:** no
- **Keg Only:** no
- **URL Keys:** head, stable

## Other Package-Manager Records

- Nix - nodenv: normalized package name match | nixpkgs package indexes: pkgs/by-name/no/nodenv/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Related links

- [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [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.
- [node-build](https://www.automicvault.com/pkg/brew/node-build/) - Runtime dependency declared by Homebrew.
- [nodebrew](https://www.automicvault.com/pkg/brew/nodebrew/) - Shares av.db curated category or tags: cli, developer-tools, development-environment, nodejs, version-manager.
- [anyenv](https://www.automicvault.com/pkg/brew/anyenv/) - Shares av.db curated category or tags: cli, developer-tools, version-manager, version-managers.
- [fvm](https://www.automicvault.com/pkg/brew/fvm/) - Shares av.db curated category or tags: cli, developer-tools, version-manager, version-managers.
- [sbtenv](https://www.automicvault.com/pkg/brew/sbtenv/) - Shares av.db curated category or tags: cli, developer-tools, version-manager, version-managers.
- [tofuenv](https://www.automicvault.com/pkg/brew/tofuenv/) - Shares av.db curated category or tags: cli, developer-tools, version-manager, version-managers.
- [fnm](https://www.automicvault.com/pkg/brew/fnm/) - Shares av.db curated category or tags: cli, developer-tools, nodejs, version-manager.
- [goenv](https://www.automicvault.com/pkg/brew/goenv/) - Shares av.db curated category or tags: cli, developer-tools, development-environment, version-manager.
- [nave](https://www.automicvault.com/pkg/brew/nave/) - Shares av.db curated category or tags: cli, developer-tools, nodejs, version-manager.
- [ndenv](https://www.automicvault.com/pkg/brew/ndenv/) - Both packages touch the same language runtime or ecosystem. Shared terms: build, cli, developer, developer-tools, manager.
- [node-env-run](https://www.automicvault.com/pkg/npm/node-env-run/) - Executable or command metadata overlaps with this package. Shared terms: cli, developer, developer-tools, environment, node.

## Combined YAML source

View the package source record on GitHub. [combined/nodenv.yml](https://github.com/automic-vault/db/blob/main/combined/nodenv.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
