Docs Set up your stack
Set up Relia in a Laravel or PHP app
Add Relia to a Laravel app with one Composer package and one artisan command, or to plain PHP with two lines. No PHP extension needed.
Relia's PHP package is pure PHP. It needs no PHP extension, so it also works on shared hosting and cPanel. To have your AI assistant do the setup instead, see Set up Relia with your AI assistant.
Before you start
- A Relia account (Create your account).
- PHP 8.1 or newer, and Composer.
- Your project's id and key. In Relia, open your project and click Setup Guide & SDK, then pick PHP / Laravel. The code shown there already holds your id and your key (the key starts with
relia_live_).
Steps (Laravel)
Install the package in your Laravel app's folder:
composer require tryrelia/reliaWrite the settings:
php artisan relia:installIt asks for your project id, then your project key. Paste each one and press Enter. The PHP / Laravel card in the setup guide also shows this command with
--project,--keyand--servicealready filled in, so you can paste it instead.Check
.env. It now has three lines:RELIA_PROJECT_ID,RELIA_KEYandRELIA_SERVICE_NAME. There's no middleware or provider to add: Laravel picks the package up by itself.Add the browser part (visitors, page speed and browser errors). Put this in your main Blade layout, just before
</head>:@reliaScriptIf your app uses Vite,
relia:installprints the lines to add toresources/js/app.jsinstead.Start your app and open any page.
Tip: if you have Node.js,
npx relia-sdk@latest initin a Laravel app does all of this for you: it installs the Composer package, writes theRELIA_*lines to.envand wires the browser part through Vite.
Steps (plain PHP)
Install the package:
composer require tryrelia/reliaStart Relia at the top of your front controller (
public/index.phporindex.php), right after<?php:require __DIR__ . '/vendor/autoload.php'; \Relia\Relia::start(['projectId' => '<your project id>', 'serviceName' => 'shop', 'key' => '<your project key>']);Add the autoloader line only if the file doesn't load Composer yet. From
public/index.phpthe path is__DIR__ . '/../vendor/autoload.php'.
Rather keep the values out of the code? Set RELIA_PROJECT_ID, RELIA_KEY and RELIA_SERVICE_NAME in your host's environment and call \Relia\Relia::start() with no arguments. Plain PHP doesn't read a .env file, so these must be real environment variables (your web server's or PHP-FPM pool's).
What Relia records
In Laravel, from the next request:
- every request with its route (
/orders/{id}), status and time; - the error behind a 500, with its stack trace;
- database queries, with values removed;
- calls made with Laravel's HTTP client;
- queue jobs;
- warning and error log lines;
- the signed-in user's id (never the e-mail).
To show plans on people ("3 customers on Pro"), see Identify your users.
Tip: watch See which customers a bug hit: identify users in Relia (2 min).
In plain PHP: each request, uncaught exceptions and fatal errors. To time a slow part on its own:
\Relia\Relia::measure('charge card', fn () => $gateway->charge($order));
The data is sent after the response, so visitors never wait for it (PHP-FPM and LiteSpeed). PHP's built-in server (php artisan serve, php -S) can't send the page first, so there each request waits a moment for the send. That's normal in development.
Settings
All optional, in .env:
| Variable | What it does |
|---|---|
RELIA_SERVICE_NAME |
The name shown in Relia (default: your app's name) |
RELIA_ENV |
development on your laptop, so test traffic stays apart (default: Laravel's APP_ENV, else production) |
RELIA_LOGS=false |
Don't send log lines |
RELIA_LOG_LEVEL=error |
Only send errors |
RELIA_QUERIES=false, RELIA_HTTP_CLIENT=false, RELIA_QUEUE=false |
Switch one part off |
RELIA_RELEASE |
Your version, if Relia can't read it from git or your host |
When you deploy
Add the same RELIA_* lines to your host's environment (Forge, Vapor, Laravel Cloud, cPanel and so on).
Check it worked
Open your project in Relia and go to the Setup tab. Requests from your server changes from Not yet to Arriving. Your requests and errors appear under APIs, and your queries under Database.
If something's wrong
relia:installsays the id is wrong: a project id is 24 letters and digits. Copy it again from the Setup tab.- The key is refused: a project key starts with
relia_live_. - No visits from the browser: check that
@reliaScriptis in the layout your pages actually use, before</head>. - Still "Not yet": see Relia shows no data.
Next
Last checked against the product: 1 Nov 2026