Environment variables

Cachet reads these settings from your .env file or your server’s environment. They control how Cachet runs. The dashboard settings control the content of your status page.

Each variable has a default. You only need to set the values 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`	Whether Cachet caches settings instead of reading them from the database on every request.

Image uploads

These variables control custom images uploaded from the Cachet dashboard:

Variable	Default	Description
`CACHET_UPLOAD_DISK`	`public`	The Laravel filesystem disk for custom images. Existing images need to be moved if the disk changes.
`CACHET_UPLOAD_MAX_SIZE`	`1024`	The maximum image upload size in kilobytes.
`CACHET_UPLOAD_IMAGE_MIME_TYPES`	`image/jpeg,image/png,image/gif,image/webp`	Comma-separated list of accepted image MIME types.

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

These variables control how the Cachet package integrates with a host Laravel 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

Image uploads

Maintenance & retention

Webhooks

Blog feed

Package integration

​Application

​API & MCP

​Telemetry & performance

​Image uploads

​Maintenance & retention

​Webhooks

​Blog feed

​Package integration

Application

API & MCP

Telemetry & performance

Image uploads

Maintenance & retention

Webhooks

Blog feed

Package integration