# Install

Use dotenvx from the command line or directly in your code. Choose the installation method that fits your project and operating system.

## CLI

```shell
curl -sfS https://dotenvx.sh | sh
```

Install the Dotenvx CLI using the official shell installer at https://dotenvx.sh. Check that this method suits my operating system, run the installer, and verify with dotenvx --version. Do not change my .env files.

## NPM

```shell
npm install @dotenvx/dotenvx
```

Install @dotenvx/dotenvx in this project using npm. Inspect the package setup first, add the dependency, and verify with npx dotenvx --version. Do not change my .env files or application code.

## Windows

```shell
winget install dotenvx
```

Install the Dotenvx CLI on Windows using winget install dotenvx. Check whether it is already installed, install if needed, and verify with dotenvx --version. Do not change my .env files.

## Brew

```shell
brew tap dotenvx/brew
brew trust dotenvx/brew
brew install dotenvx
```

Install the Dotenvx CLI using Homebrew. Check that Homebrew is available, run brew tap dotenvx/brew, brew trust dotenvx/brew, and brew install dotenvx, then verify with dotenvx --version. Do not change my .env files.

## GitHub Releases

```shell
curl -L -o dotenvx.tar.gz "https://github.com/dotenvx/dotenvx/releases/latest/download/dotenvx-$(uname -s)-$(uname -m).tar.gz"
tar -xzf dotenvx.tar.gz
./dotenvx help
```

Install the Dotenvx CLI from the latest official GitHub release at https://github.com/dotenvx/dotenvx/releases. Detect my operating system and architecture, download and extract the matching binary, put it in an appropriate location on my PATH, and verify with dotenvx --version. Do not change my .env files.

## Docker

```shell
docker run --rm -v "$(pwd):/app" dotenv/dotenvx help
```

Use the official dotenv/dotenvx Docker image. Check that Docker is available, pull the image, and verify it with docker run --rm dotenv/dotenvx --version. Mount my project at /app when running project commands. Do not change my .env files.

## Standalone

```shell
curl -sfS --proto '=https' "https://dotenvx.sh/$(uname)/$(uname -m).tgz" | tar xz
sudo install -m 755 dotenvx /usr/local/bin
dotenvx --version
```

To pin a version, append ?version=vVERSION to the download URL, replacing VERSION with your desired release number. The install command puts dotenvx on your PATH at /usr/local/bin.

Install the standalone Dotenvx binary from https://dotenvx.sh. Detect my operating system and architecture, download the matching binary, put it in an appropriate location on my PATH, and verify with dotenvx --version. If I request a specific version, append ?version=vVERSION to the download URL. Do not change my .env files.

## Node.js SDK

```shell
npm install @dotenvx/dotenvx
```

[Node.js SDK documentation](https://dotenvx.com/docs/sdk/nodejs/)

Install the Dotenvx Node.js SDK in this project using npm install @dotenvx/dotenvx. Inspect the package setup first, add the dependency, and verify that the package can be imported. See https://dotenvx.com/docs/sdk/nodejs/ for usage. Do not change my .env files or application code.

## Ruby SDK

```shell
gem install dotenvx
```

[Ruby SDK documentation](https://dotenvx.com/docs/sdk/ruby/)

Install the Dotenvx Ruby SDK in this project. Inspect its Ruby and Bundler setup first, add the dotenvx gem using the project's dependency workflow, and verify that require "dotenvx" succeeds. See https://github.com/dotenvx/dotenvx-ruby for usage. Do not change my .env files or application code.

## Python SDK

```shell
pip install python-dotenvx
```

[Python SDK documentation](https://dotenvx.com/docs/sdk/python/)

Install the Dotenvx Python SDK in this project using pip install python-dotenvx. Inspect its Python environment and dependency workflow first, add the dependency in the appropriate environment, and verify that import dotenvx succeeds. See https://github.com/dotenvx/python-dotenvx for usage. Do not change my .env files or application code.

## NPM global

```shell
npm install --global @dotenvx/dotenvx
```

Install @dotenvx/dotenvx globally with npm and verify with dotenvx --version. Check the existing installation first. Do not change my .env files.

## NPX

```shell
npx @dotenvx/dotenvx --version
```

Run npx @dotenvx/dotenvx --version to verify that I can use Dotenvx through npx. Do not change my .env files or project dependencies.

## Wget

```shell
wget -qO- https://dotenvx.sh | sh
```

Install the Dotenvx CLI using wget -qO- https://dotenvx.sh | sh. Check that this method suits my operating system and verify with dotenvx --version. Do not change my .env files.

For usage, follow the [Node.js guide](https://dotenvx.com/docs/nodejs.md). Deploying on Heroku? See the [Heroku guide](https://dotenvx.com/docs/platforms/heroku/).