Environment Variables - Grind

Grind reads configuration from environment variables. Copy .env.example to .env in the repo root for local development.

Vault

Variable	Default	Description
`GRIND_VAULT_PATH`	`~/.grind/vault.db`	Path to the SQLite vault database
`GRIND_ENCRYPTION_KEY`	—	AES encryption key for the vault (generated on `init`)

Companion & AI

Variable	Default	Description
`GRIND_ENABLE_COMPANION`	`false`	Enable the AI companion
`GRIND_DEFAULT_MODEL`	`anthropic:claude-3-5-haiku-latest`	Default model identifier (`provider:model`)
`ANTHROPIC_API_KEY`	—	Anthropic API key
`OPENAI_API_KEY`	—	OpenAI API key
`GOOGLE_GENERATIVE_AI_API_KEY`	—	Google Gemini API key
`OLLAMA_BASE_URL`	`http://localhost:11434/v1`	Ollama endpoint for local models

Turso (Cloud Sync)

Variable	Default	Description
`TURSO_DATABASE_URL`	—	Turso database URL (`libsql://your-db.turso.io`)
`TURSO_AUTH_TOKEN`	—	Turso auth token

Both must be set to enable cloud sync. If either is missing, Grind operates in local-only mode.

Gateway

Variable	Default	Description
`GRIND_GATEWAY_HOST`	`127.0.0.1`	Host the gateway server binds to
`GRIND_GATEWAY_PORT`	`5174`	Port the gateway listens on
`GRIND_GATEWAY_TOKEN`	—	Shared secret for generic `/hooks/inbound`

Telegram

Variable	Description
`GRIND_TELEGRAM_BOT_TOKEN`	Telegram bot token from @BotFather
`GRIND_TELEGRAM_WEBHOOK_SECRET`	Secret for webhook verification
`GRIND_TELEGRAM_WEBHOOK_PATH`	Webhook path (default: `/hooks/telegram`)

Discord

Variable	Description
`GRIND_DISCORD_PUBLIC_KEY`	Discord app public key for Ed25519 signature verification
`GRIND_DISCORD_WEBHOOK_PATH`	Webhook path (default: `/hooks/discord`)

WhatsApp

Variable	Description
`GRIND_WHATSAPP_MODE`	`cloud` (Cloud API) or `web` (Baileys)
`GRIND_WHATSAPP_VERIFY_TOKEN`	Token for webhook challenge verification
`GRIND_WHATSAPP_APP_SECRET`	App secret for HMAC signature verification
`GRIND_WHATSAPP_WEBHOOK_PATH`	Webhook path (default: `/hooks/whatsapp`)
`GRIND_WHATSAPP_ACCESS_TOKEN`	WhatsApp Cloud API access token
`GRIND_WHATSAPP_PAIRING_METHOD`	`qr` or `phone` (for Baileys mode)
`GRIND_WHATSAPP_PAIRING_PHONE`	Phone number for pairing code method
`GRIND_WHATSAPP_LINKED_AT`	Timestamp of last Baileys session link

Google Calendar

Variable	Description
`GRIND_GOOGLE_CALENDAR_CHANNEL_TOKEN`	Token for push notification verification
`GRIND_GOOGLE_CALENDAR_WEBHOOK_PATH`	Webhook path (default: `/hooks/google-calendar`)