Skip to main content

Environment Variables

zopp can be configured using environment variables as an alternative to command-line flags or configuration files.

Connection​

VariableDescriptionDefault
ZOPP_SERVERServer addresshttp://127.0.0.1:50051
ZOPP_TLS_CA_CERTPath to CA certificate for TLS verificationNone

Defaults​

VariableDescriptionDefault
ZOPP_WORKSPACEDefault workspace nameNone
ZOPP_PROJECTDefault project nameNone
ZOPP_ENVIRONMENTDefault environment nameNone

Server Configuration (zopp-server)​

These variables configure the zopp server process.

Email Verification​

VariableDescriptionDefault
ZOPP_EMAIL_VERIFICATION_REQUIREDRequire email verification for new userstrue (when provider configured)
ZOPP_EMAIL_PROVIDEREmail provider: resend or smtpNone
ZOPP_EMAIL_FROMSender email addressRequired when provider set
ZOPP_EMAIL_FROM_NAMESender display nameNone

Resend Provider​

VariableDescriptionDefault
RESEND_API_KEYResend API keyRequired for Resend

SMTP Provider​

VariableDescriptionDefault
SMTP_HOSTSMTP server hostnameRequired for SMTP
SMTP_PORTSMTP server port587
SMTP_USERNAMESMTP authentication usernameNone
SMTP_PASSWORDSMTP authentication passwordNone
SMTP_USE_TLSEnable TLS/STARTTLStrue

Precedence​

Configuration is resolved in this order (highest to lowest priority):

  1. Command-line flags (--server, -w, etc.)
  2. Environment variables
  3. Configuration file (zopp.toml)
  4. Built-in defaults

Examples​

Connect to a remote server​

export ZOPP_SERVER=https://zopp.example.com:50051
export ZOPP_TLS_CA_CERT=/path/to/ca.crt
zopp workspace list

Set defaults for a session​

export ZOPP_WORKSPACE=mycompany
export ZOPP_PROJECT=api-backend
export ZOPP_ENVIRONMENT=staging

# Now these use the environment defaults
zopp secret list
zopp secret get DATABASE_URL

CI/CD environments​

# GitHub Actions
env:
  ZOPP_SERVER: https://zopp.example.com:50051
  ZOPP_WORKSPACE: mycompany
  ZOPP_PROJECT: api-backend
  ZOPP_ENVIRONMENT: production

See Also​