ev
evnx

Install evnx

Get up and running in seconds. Pick your preferred installation method below.

macOS / LinuxCargonpmpip / pipxFrom SourceWindowsTroubleshooting

macOS & Linux

One-liner install via our automated shell script — no Rust toolchain required.

curl -fsSL https://dotenv.space/install.sh | bash

Cargo (Rust)

Requires Rust 1.70+. Install Rust at rustup.rs. The default install includes the core command set. Add --features full to also get migrate and backup/restore.

Core (default)

cargo install evnx

All features — migrate + backup

cargo install evnx --features full
Feature flags at a glance
  • --features migrate — adds the evnx migrate command
  • --features backup — adds evnx backup / evnx restore
  • --features full — enables both of the above

npm (Node.js)

The npm package is published as @evnx/cli. Install it globally so the evnx binary is available everywhere.

Global install (recommended)

npm install -g @evnx/cli

Or run without installing

npx @evnx/cli --version

Requires Node.js 18+. After a global install, run evnx --version to confirm.

pip / pipx (Python)

The package is published on PyPI as evnx. We recommend pipx for CLI tools — it installs into an isolated environment and places the binary on your PATH automatically.

Recommended — pipx

pipx install evnx

Alternative — pip (see note below)

pip install evnx

⚠️ pip vs pipx

pip install evnx may install the package but not expose the evnx binary on your PATH if you use a virtual environment or a system Python with restricted bin directories. If the evnx command is not found after a pip install, use pipx install evnx instead. Install pipx with pip install pipx or brew install pipx.

Build from Source

If you have rustc or cargo installed, you can compile directly from the GitHub repository.

Bash
git clone https://github.com/urwithajit9/evnx.gitcd evnx # Core buildcargo build --release # Full build (migrate + backup features)cargo build --release --features full # Copy to a directory on your PATHcp target/release/evnx ~/.local/bin/

Requires Rust 1.70+. Install Rust via rustup.rs.

Windows

Cargo (recommended)

cargo install evnx

The most reliable option on Windows. Requires Rust — install via rustup.rs.

winget

winget install evnx

ℹ️ winget support status

A winget package submission is in progress. Until it is accepted into the Windows Package Manager Community Repository, this command may fail with "No package found". If so, use cargo install evnx or npm as the primary Windows installation path.

Verify Installation

Check that evnx is installed correctly:

Bash
evnx --versionevnx 0.2.1

Troubleshooting

pip install evnx succeeds but evnx command is not found

This happens when pip installs the package into a location that isn't on your system PATH — common with virtual environments, system Python on macOS/Linux, or --user installs.

Fix: use pipx instead

pip install pipx && pipx install evnx

pipx creates a dedicated virtual environment for each CLI tool and automatically adds its binary to your PATH. It is the recommended way to install Python-packaged CLI utilities.

Alternatively, try running python -m evnx as a workaround if pipx isn't available.

npm install @evnx/cli (local) doesn't expose the evnx binary

A local npm install (without -g) places the binary in ./node_modules/.bin/evnx, which is only available inside npm scripts or when you prefix your command with ./node_modules/.bin/.

Fix 1: install globally

npm install -g @evnx/cli

Fix 2: run without installing via npx

npx @evnx/cli --version

npx downloads and executes the package on-demand — useful for one-off uses or CI pipelines where you don't want a global install.

cargo: command not found

Rust and Cargo are not installed. Install the full toolchain with:

curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Then restart your terminal (or run source ~/.cargo/env) so the new $PATH entry takes effect.

winget install evnx — "No package found matching input criteria"

The winget manifest has not yet been merged into the Windows Package Manager Community Repository. Until the PR is accepted, install via Cargo or npm instead:

cargo install evnx

Permission errors during install on macOS / Linux

Never run sudo pip install or sudo npm install -g — this can corrupt system-level Python/Node environments. Instead:

  • For pip: switch to pipx install evnx
  • For npm: configure npm to use a user-writable global prefix — npm config set prefix ~/.npm-global, then add ~/.npm-global/bin to your PATH
  • For cargo: no changes needed — cargo installs to ~/.cargo/bin by default

What's Next?

Now that evnx is installed, learn how to use it:

Read GuidesView on GitHub