lizard run

Run a command locally with project and service secrets injected.

run vs. ssh

Two commands let you execute commands with a service’s context. They run in different places — know which one you want.

CommandRuns whereUse for
lizard runLocally, with the service’s project + service secrets injectedMigrations, seed scripts, local tooling that needs prod config
lizard sshInside the running service VMInspecting the live container, one-off remote commands, debugging

lizard run shows your local injected copy of the environment, which is usually the same as what the running app sees — but lizard ssh is authoritative for the live container. To check what the running app actually sees, use lizard ssh instead.

Usage

lizard run [flags] -- <command>

Flags

FlagDescription
-s, --service <name>Service whose env to inject
--no-serviceDon’t inject service env

Examples

Run a migration with service secrets injected

lizard run --service api -- node scripts/migrate.js
lizard run --service api -- printenv DATABASE_URL

See also

  • lizard ssh — execute a command inside the running service VM instead of locally
  • Variables — how project and service variables are defined and referenced