Skip to content
Ghaymah Ghaymah Ghaymah Docs

Environment variables

Environment variables store configuration and secrets your app reads at runtime — database URLs, API keys, feature flags, and more. gy manages them without requiring a redeploy.

Set a variable

Section titled “Set a variable”
Terminal window
gy config set env DATABASE_URL=postgres://user:pass@host:5432/db
gy config set env DEBUG=true

Update a variable

Section titled “Update a variable”

Setting an existing key overwrites its value:

Terminal window
gy config set env DEBUG=false

Remove a variable

Section titled “Remove a variable”
Terminal window
gy config unset env DEBUG

Push changes

Section titled “Push changes”
Terminal window
gy config sync

Using them in your app

Section titled “Using them in your app”

Read them the standard way for your language:

import os
DATABASE_URL = os.environ["DATABASE_URL"]
const dbUrl = process.env.DATABASE_URL;

Secrets in .gy.json

Section titled “Secrets in .gy.json”

Variables are stored in your project’s .gy.json under env:

{
  "env": {
    "DATABASE_URL": "postgres://…",
    "API_KEY": "…"
  }
}