CLI

handoff push

Upload your local .env file to a Handoff environment.

Usage

handoff push [--env <name>] [--file <path>] [--yes]

What it does

Reads a local .env file, encrypts each value with the organization key, and writes the result to the selected environment. Existing remote values are versioned: nothing is destroyed, and a rollback is always a dashboard click away.

By default push prints a diff of what will change and asks you to confirm.

Flags

FlagDefaultDescription
-e, --env <name>default env from .handoff/config.jsonTarget environment
-f, --file <path>.envLocal file to push
-y, --yesfalseSkip the confirmation prompt

Examples

Push to a non-default environment:

handoff push --env production

Push a non-standard file:

handoff push --file .env.local

Skip the prompt (non-interactive contexts):

handoff push --env production --yes