Environment variables

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.

Application

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.

API & MCP

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.

Telemetry & performance

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.

Maintenance & retention

Variable	Default	Description
`CACHET_PRUNE_CHECKS_AFTER_DAYS`	`30`	Number of days to keep component check results before they are pruned.

Webhooks

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.

Blog feed

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.

Package integration

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.

Getting Started

Guide

Configuration

Integrations

Other

Environment variables

Application

API & MCP

Telemetry & performance

Maintenance & retention

Webhooks

Blog feed

Package integration

​Application

​API & MCP

​Telemetry & performance

​Maintenance & retention

​Webhooks

​Blog feed

​Package integration

Application

API & MCP

Telemetry & performance

Maintenance & retention

Webhooks

Blog feed

Package integration