All credentials go in the root .env file. Below is the full reference grouped by service.
Linear
| Variable | Description | How to obtain |
|---|
LINEAR_API_TOKEN | Personal API token | Linear Settings → API → "Personal API keys" |
Slack
| Variable | Description | How to obtain |
|---|
SLACK_BOT_TOKEN | Bot user OAuth token (xoxb-...) | Slack API Apps → your app → "OAuth & Permissions" |
Crisp
| Variable | Description | How to obtain |
|---|
CRISP_WEBSITE_ID | Website identifier | Crisp Dashboard → Settings → Website Settings |
CRISP_IDENTIFIER | API token ID | Crisp Marketplace → your plugin → Tokens |
CRISP_KEY | API token key | Same as above |
Stripe
| Variable | Description | How to obtain |
|---|
STRIPE_API_KEY | Secret key (sk_...) | Stripe Dashboard |
Mailgun
| Variable | Description | How to obtain |
|---|
MAILGUN_API_KEY | API key | Mailgun Dashboard |
MAILGUN_API_BASE | API base URL | Default: https://api.mailgun.net/v4 |
Featurebase
| Variable | Description | How to obtain |
|---|
FEATUREBASE_API_KEY | API key | Featurebase → Settings → API |
Google (OAuth)
All Google handlers share a single OAuth Client. See the Google OAuth Setup guide for the full walkthrough.
| Variable | Description |
|---|
GMAIL_CLIENT_ID | OAuth client ID (shared across all Google handlers) |
GMAIL_CLIENT_SECRET | OAuth client secret (shared) |
GMAIL_REFRESH_TOKEN | Run php scripts/gmailHandler.php setup |
GOOGLE_CALENDAR_REFRESH_TOKEN | Run php scripts/calendarHandler.php setup |
GOOGLE_DOCS_REFRESH_TOKEN | Run php scripts/googleDocsHandler.php setup |
Google Play Reviews
Uses a Service Account instead of OAuth.
| Variable | Description | How to obtain |
|---|
GOOGLE_PLAY_SERVICE_ACCOUNT_JSON | Path to service account JSON | Google Cloud Console → IAM → Service Accounts |
GOOGLE_PLAY_PACKAGE_NAME | App package name | Default: la.publica.reader |
Farfalla API
Multi-tenant configuration for direct API access.
| Variable | Description |
|---|
FARFALLA_TENANTS | Comma-separated list of tenant codes (e.g. mb) |
FARFALLA_DEFAULT_TENANT | Default tenant code |
FARFALLA_URL_<CODE> | Base URL per tenant (e.g. FARFALLA_URL_MB) |
FARFALLA_TOKEN_<CODE> | API token per tenant (e.g. FARFALLA_TOKEN_MB) |