> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ezforge.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# CLI Overview

> ezforge — command-line tool for managing MCP servers

The `ezforge` CLI lets you deploy and manage MCP servers from the terminal.

<Note>
  The `ezforge` CLI is currently at `v0.1.0` (pre-GA). Commands and flags may change before `v1.0.0`.
</Note>

## Installation

<Tabs>
  <Tab title="Homebrew (macOS / Linux)">
    ```bash theme={null}
    brew install ezforgeai/tap/ezforge
    ```
  </Tab>

  <Tab title="Download binary">
    Download the latest pre-built binary for your platform from [GitHub Releases](https://github.com/ezforgeai/ezforge-cli/releases/latest), extract, and move `ezforge` onto your `$PATH`. See [Quickstart → Install the CLI](/getting-started/quickstart#step-1-install-the-cli) for the full platform asset list and checksum verification.
  </Tab>
</Tabs>

Verify:

```bash theme={null}
ezforge --version
```

## Commands

| Command                                       | Description                                 |
| --------------------------------------------- | ------------------------------------------- |
| [`ezforge auth`](/cli-reference/auth)         | Authenticate with ezForge Platform          |
| [`ezforge deploy`](/cli-reference/deploy)     | Deploy an MCP server                        |
| [`ezforge servers`](/cli-reference/servers)   | List and manage servers                     |
| [`ezforge logs`](/cli-reference/logs)         | Stream server logs                          |
| [`ezforge rollback`](/cli-reference/rollback) | Roll back to a previous version             |
| [`ezforge env`](/cli-reference/env)           | Manage environment variables                |
| [`ezforge project`](/cli-reference/project)   | Manage projects                             |
| [`ezforge billing`](/cli-reference/billing)   | Manage subscription and view billing status |

Run `ezforge <command> --help` for detailed usage of any command.

## Configuration file

Place an `ezforge.toml` in your project root to set defaults:

```toml theme={null}
[project]
name = "my-first-project"

[server]
name = "my-server"
region = "ord"
cpu = "shared-1x"
memory = "256mb"

[build]
container_file = "./Dockerfile"

[health]
path = "/healthz"
timeout = 30

[deploy]
auto_rollback = true
retention_count = 10
```

**All fields are optional** — missing values fall back to CLI flags or platform defaults.

## Global flags

| Flag              | Description                                |
| ----------------- | ------------------------------------------ |
| `--project <id>`  | Override the project from `ezforge.toml`   |
| `--api-key <key>` | Use a specific API key (overrides env var) |
| `--json`          | Output as JSON (machine-readable)          |
| `--help`          | Show help                                  |
| `--version`       | Show version                               |

## Environment variables

| Variable          | Description                          |
| ----------------- | ------------------------------------ |
| `EZFORGE_API_KEY` | API key (alternative to `--api-key`) |
| `EZFORGE_PROJECT` | Default project ID                   |
| `EZFORGE_API_URL` | Override API endpoint (for testing)  |