Skip to main content

​
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

Verify the installation:

​
Step 2 — Create an API token

  1. Sign in at 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_)
Your token is only shown once. Store it somewhere safe before closing the modal.

​
Step 3 — Log in

​
Step 4 — Initialise your project

Navigate to your project directory and run:
This creates a .ev.json file:

​
Step 5 — Push your secrets

Make sure you have a .env file in the current directory, then:
winterandsummer is your lock key — the passphrase used to derive the AES encryption key. You need this to pull secrets later. Keep it safe.

​
Step 6 — Pull secrets on another machine

After logging in on the target machine:
Your .env is now populated — entirely decrypted on your local machine.

​
Next steps

CLI Reference

All CLI commands and flags.

Token Scopes

Understand read, write, and admin scopes.

Team Access

Add team members to your project.

VS Code Extension

Install the VS Code extension for leak detection.