> For the complete documentation index, see [llms.txt](https://docs.nullify.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.nullify.ai/cli/cli/install.md).

# Installation

## Quick Install

Run the install script to download the latest Nullify CLI binary:

```bash
curl -sSfL https://raw.githubusercontent.com/Nullify-Platform/cli/main/install.sh | sh -s -- --host api.<TENANT>.nullify.ai
```

Replace `<TENANT>` with your organization name (e.g. `api.acme.nullify.ai`).

{% hint style="info" %}
The `curl | sh` installer runs on macOS and Linux. It does not run on native Windows — use [WSL](https://learn.microsoft.com/windows/wsl/) or Git Bash, or follow the [Manual Installation](#manual-installation) steps with the Windows archive below.
{% endhint %}

This will:

* Detect your OS and architecture (macOS, Linux; amd64, arm64)
* Download the latest release from [GitHub Releases](https://github.com/Nullify-Platform/cli/releases)
* Verify the SHA256 checksum
* Install the binary to `/usr/local/bin/nullify` (or `~/.local/bin/`)
* Configure the CLI to connect to your Nullify instance

## Manual Installation

Download the latest archive for your platform from [GitHub Releases](https://github.com/Nullify-Platform/cli/releases):

| Platform | Architecture          | Archive                       |
| -------- | --------------------- | ----------------------------- |
| macOS    | Apple Silicon (arm64) | `nullify_darwin_arm64.tar.gz` |
| macOS    | Intel (amd64)         | `nullify_darwin_amd64.tar.gz` |
| Linux    | amd64                 | `nullify_linux_amd64.tar.gz`  |
| Linux    | arm64                 | `nullify_linux_arm64.tar.gz`  |
| Windows  | amd64                 | `nullify_windows_amd64.zip`   |

After downloading:

```bash
tar -xzf nullify_<os>_<arch>.tar.gz
sudo mv nullify /usr/local/bin/nullify
```

### With Go

If you have a Go toolchain installed, you can build and install the CLI directly:

```bash
go install github.com/nullify-platform/cli/cmd/cli@latest
```

## Verify Installation

```bash
nullify --version
```

## Configuration

The CLI resolves which Nullify instance to connect to in this order:

1. The `--host` flag
2. The `NULLIFY_HOST` environment variable
3. The host saved in `~/.nullify/config.json` by `nullify auth login`

```bash
# 1. Set via flag (highest priority)
nullify --host api.<TENANT>.nullify.ai <command>

# 2. Or set via environment variable
export NULLIFY_HOST=api.<TENANT>.nullify.ai
nullify <command>
```

`NULLIFY_HOST` (and `--host`) accept either the full API host `api.<TENANT>.nullify.ai` or the bare `<TENANT>.nullify.ai` form. The CLI stores the host in its bare `<TENANT>.nullify.ai` form and adds the `api.` prefix automatically when it makes API requests, so either form works.

## Next Steps

* [Authentication Guide](/cli/cli/authentication.md) - Log in to your Nullify instance
* [MCP Setup Guide](/cli/cli/mcp-setup.md) - Connect your AI coding assistant