ev init

Usage

ev init [name] [flags]

Description

ev init must be run from the root of a git repository. It does four things:

  1. Registers a new project with the ev server (or joins an existing one via passphrase)
  2. Generates a local keypair and stores it in ~/.config/ev/keys.json
  3. Creates ev.yaml in the current directory
  4. Adds ev-related entries to .gitignore (.env, .env.backup, ~/.config/ev/)

If [name] is omitted, ev uses the current directory name.

Monorepo Detection

If ev detects subdirectories containing package.json files at the time of ev init, it prompts you to configure them as named apps in ev.yaml. You can skip this and edit ev.yaml manually.

Joining an Existing Project

If a teammate has already initialized the project, use --passphrase to join without a live key-exchange flow:

ev init --passphrase "correct horse battery staple"

The passphrase is generated by ev access rotate and encodes the project key in a human-readable form. It can only be used once.

Flags

FlagDescription
--passphraseJoin an existing project using a shared passphrase instead of creating a new one

Examples

Initialize a new project using the current directory name:

ev init

Initialize a new project with a specific name:

ev init my-backend-service

Join an existing project via passphrase:

ev init --passphrase "correct horse battery staple"

On this page