| title |
Environment variables |
| description |
Configure Cachet using environment variables. |
| icon |
sliders |
Cachet reads a number of settings from your environment, defined in your .env file (or your server's environment).
These sit alongside the dashboard settings and generally control how Cachet is installed
and served, rather than the content of your status page.
Every variable has a sensible default, so you only need to set the ones you want to change.
| Variable |
Default |
Description |
CACHET_PATH |
/ |
The URI path Cachet is served from. |
CACHET_DOMAIN |
(none) |
The domain Cachet is served from. Leave unset to serve from the application's default domain. |
CACHET_TITLE |
"${APP_NAME} - Status" |
The title of your status page. |
CACHET_TRUSTED_PROXIES |
(empty) |
Comma-separated list of trusted proxy IPs. See Theme for details. |
CACHET_DOCKER |
false |
Whether Cachet is running inside a Docker container. Set automatically by the official Docker image. |
CACHET_DEMO_MODE |
false |
Runs Cachet in demo mode, adjusting some defaults for a demo environment. |
| Variable |
Default |
Description |
CACHET_API_RATE_LIMIT |
300 |
Requests per minute allowed against the API. |
CACHET_MCP_RATE_LIMIT |
300 |
Requests per minute allowed against the MCP server. |
| Variable |
Default |
Description |
CACHET_BEACON |
true |
Whether Cachet sends anonymous telemetry. Set to false to opt out. |
CACHET_SETTINGS_CACHE |
true |
Cache Cachet's settings instead of reading them from the database on every request. |
| Variable |
Default |
Description |
CACHET_PRUNE_CHECKS_AFTER_DAYS |
30 |
Number of days to keep component check results before they are pruned. |
| Variable |
Default |
Description |
CACHET_WEBHOOK_QUEUE_CONNECTION |
(app default) |
The queue connection used to dispatch webhooks. |
CACHET_WEBHOOK_QUEUE_NAME |
(app default) |
The queue name used to dispatch webhooks. |
| Variable |
Default |
Description |
CACHET_FEED_URI |
https://blog.cachethq.io/rss |
The RSS feed used to display blog posts on your status page. |
CACHET_FEED_CACHE |
3600 |
How long, in seconds, to cache the blog feed. |
When running Cachet as a package inside an existing Laravel application, the following variables control how it
integrates with your host application:
| Variable |
Default |
Description |
CACHET_GUARD |
(default guard) |
The authentication guard Cachet uses. |
CACHET_USER_MODEL |
App\Models\User |
The user model Cachet authenticates against. |
CACHET_USER_MIGRATIONS |
true |
Whether Cachet loads the default user migrations. |
CACHET_RUN_MIGRATIONS |
true |
Whether Cachet loads its migrations. Disable if your application manages them itself. |
CACHET_REGISTER_SCHEDULES |
true |
Whether Cachet registers its scheduled tasks. Disable if your application schedules them itself. |