michal-palus1/telescope-central

Centralize Laravel Telescope using DB config

v1.0.4 2025-10-15 14:11 UTC

Requires

• php: >=8.1
• illuminate/support: ^9.0 || ^10.0 || ^11.0
• laravel/telescope: ^3.0 || ^4.0 || ^5.0

MIT

README

Centralize Laravel Telescope storage using .env-based DB configuration in each project (no inline secrets).

What it does

• Adds a telescope_central (or your custom) DB connection at runtime from .env
• Points Telescope to that connection (if creds are present)
• Records only in environments you allow (TELESCOPE_RECORD_ENVS, default: production)
• Tags entries with app:{APP_NAME}, env:{environment}, host:{hostname}
• Auto-filters UI to your app tag when opening /telescope (can be turned off)

Install

composer require michal-palus1/telescope-central
php artisan vendor:publish --tag=telescope-central-config

.env in each project

Set these in every project that should write to the central DB:

TELESCOPE_DB_HOST=
TELESCOPE_DB_DATABASE=
TELESCOPE_DB_USERNAME=
TELESCOPE_DB_PASSWORD=

Notes

• No pruning or UI auth logic is included in this minimal build.
• To fully hide the UI, set TELESCOPE_DISABLE_UI=true.
• To disable the default UI tag redirect, set TELESCOPE_UI_DEFAULT_FILTER=false.