Zeabur Variables Management

Always use

npx zeabur@latest

to invoke Zeabur CLI. Never use

zeabur

directly or any other installation method. If

npx

is not available, install Node.js first.

Do not guess CLI syntax. Only

create

,

update

,

delete

,

env

, and

list

are valid subcommands. Subcommands like

set

or

add

do not exist and will silently fail with no error output.

Known Issues

1. Use

   --id

   not

   --name

   — name lookup is unreliable

2. ${VAR}

   gets empty — shell expands before CLI receives; use single quotes

3. variable env

   replaces ALL variables — it overwrites the entire variable set with the .env file contents; existing variables not in the file will be removed

Create Variables

update

# Always use service ID — use the `zeabur-service-list` skill to get it
npx zeabur@latest variable create --id <service-id> \
  -k "KEY1=value1" \
  -k "KEY2=value2" \
  -y -i=false

Update Variables

npx zeabur@latest variable update --id <service-id> \
  -k "KEY1=new_value1" \
  -k "KEY2=new_value2" \
  -y -i=false

Delete Variables

npx zeabur@latest variable delete --id <service-id> \
  --delete-keys "KEY1" \
  --delete-keys "KEY2" \
  -y -i=false

List Variables

npx zeabur@latest variable list --id <service-id> -i=false

Load from .env File

Warning: This replaces ALL variables on the service with the contents of the .env file. Existing variables not in the file will be removed.

npx zeabur@latest variable env --id <service-id> -f .env

env

Variable References

Warning: The CLI

-k

flag uses Cobra's

StringToStringVar

parser which cannot reliably handle values containing

${}

, even with single quotes. The value may be truncated or emptied. See zeabur/cli#201.

# WRONG — shell expands ${VAR} to empty
npx zeabur@latest variable create --id <service-id> -k "REDIS_URL=${REDIS_URI_INTERNAL}" -y -i=false

# STILL UNRELIABLE — single quotes prevent shell expansion but Cobra's CSV parser may still mangle the value
npx zeabur@latest variable create --id <service-id> -k 'REDIS_URL=${REDIS_URI_INTERNAL}' -y -i=false

# RECOMMENDED — set variable references in Zeabur Dashboard
# Or use GraphQL API with updateEnvironmentVariable(data: Map!) mutation

${POSTGRES_CONNECTION_STRING}

Quick Reference

npx zeabur@latest variable create --id <service-id> -k "K=V" -y -i=false

npx zeabur@latest variable update --id <service-id> -k "K=V" -y -i=false

npx zeabur@latest variable delete --id <service-id> --delete-keys "K" -y -i=false

npx zeabur@latest variable env --id <service-id> -f .env

npx zeabur@latest variable list --id <service-id> -i=false