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

# Quickstart

> Get Enver running in under 5 minutes.

# Quickstart

This guide walks you through installing the CLI, creating your first project, and pushing your first set of secrets.

## Step 1 — Install the CLI

<CodeGroup>
  ```bash Homebrew theme={null}
  brew install enver-os/tap/ev
  ```

  ```bash npm theme={null}
  npm install -g @enver-os/cli
  ```
</CodeGroup>

Verify the installation:

```bash theme={null}
ev --version
# ev v1.0.0
```

## Step 2 — Create an API token

1. Sign in at [app.enver-os.xyz](https://app.enver-os.xyz)
2. Go to **Settings → API Tokens**
3. Click **Generate Token**, choose `write:secrets` scope
4. Copy the token (starts with `env_live_`)

<Warning>
  Your token is only shown once. Store it somewhere safe before closing the modal.
</Warning>

## Step 3 — Log in

```bash theme={null}
ev login env_live_your_token_here
```

```
TOKEN:  env_live_...
✓ Successfully logged in! Session token saved.
```

## Step 4 — Initialise your project

Navigate to your project directory and run:

```bash theme={null}
ev init
```

This creates a `.ev.json` file:

```json theme={null}
{
  "projectId": "my-app",
  "name": "My App",
  "defaultEnvironment": "DEVELOPMENT"
}
```

## Step 5 — Push your secrets

Make sure you have a `.env` file in the current directory, then:

```bash theme={null}
ev push winterandsummer
```

```
⠿ Reading local .env file...
⠿ Encrypting with AES-256-GCM + Shamir SSS...
⠿ Uploading encrypted payload to DEVELOPMENT...
✓ Successfully encrypted & pushed .env to remote (DEVELOPMENT)
```

<Info>
  `winterandsummer` is your **lock key** — the passphrase used to derive the AES encryption key. You need this to pull secrets later. Keep it safe.
</Info>

## Step 6 — Pull secrets on another machine

After logging in on the target machine:

```bash theme={null}
ev pull winterandsummer
```

```
⠿ Fetching secret payload for [my-app] (DEVELOPMENT)...
⠿ Decrypting secrets locally...
✓ Successfully pulled and decrypted envs into .env (DEVELOPMENT)
```

Your `.env` is now populated — entirely decrypted on your local machine.

***

## Next steps

<CardGroup cols={2}>
  <Card title="CLI Reference" icon="terminal" href="/cli/overview">
    All CLI commands and flags.
  </Card>

  <Card title="Token Scopes" icon="key" href="/api-reference/authentication">
    Understand read, write, and admin scopes.
  </Card>

  <Card title="Team Access" icon="users" href="/api-reference/projects">
    Add team members to your project.
  </Card>

  <Card title="VS Code Extension" icon="puzzle-piece" href="/vscode-extension">
    Install the VS Code extension for leak detection.
  </Card>
</CardGroup>