.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.
Documentation Index
Fetch the complete documentation index at: /docs/llms.txt
Use this file to discover all available pages before exploring further.
Configure Cachet using environment variables.
.env file or your server’s environment.
They control how Cachet runs. The dashboard settings control the content of your status page.
| 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 | Whether Cachet caches settings instead of reading them from the database on every request. |
| 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. |
| 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. |
| 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. |