Appearance
Try it locally
You can run Replora on your own computer to try it, test an update or develop a module, with PHP's built-in server and a local PostgreSQL. Addresses on your own computer are free: the license is never attached to them, so the same purchase code still works on your real domain afterwards.
Install PHP and PostgreSQL
You need PHP 8.3 or newer with the extensions from Server requirements and a PostgreSQL server.
bash
brew install [email protected] postgresql@17
brew services start postgresql@17
createuser -P replora # asks for a password
createdb -O replora replorabash
sudo apt install -y php8.3-cli php8.3-pgsql php8.3-mbstring php8.3-xml php8.3-curl php8.3-zip postgresql unzip
sudo -u postgres psql -c "CREATE USER replora WITH PASSWORD 'secret';"
sudo -u postgres psql -c "CREATE DATABASE replora OWNER replora;"bash
docker run -d --name replora-db -p 127.0.0.1:5432:5432 \
-e POSTGRES_DB=replora -e POSTGRES_USER=replora -e POSTGRES_PASSWORD=secret \
-v replora-db:/var/lib/postgresql/data postgres:17-alpineOn Windows, use WSL 2 with Ubuntu and follow the Ubuntu tab.
Unpack and start the server
bash
unzip replora-single-1.0.0.zip
cd replora-single-1.0.0
php artisan servephp artisan serve prints the address, usually http://127.0.0.1:8000. While Replora isn't installed, the server doesn't restart when the installer writes .env (Replora is not installed yet: this server won’t restart while the installer writes .env.), so the installation can't be interrupted halfway.
To use another port: php artisan serve --port=8010.
Run the installer
Open the printed address, for example http://127.0.0.1:8000. The installer opens:
- Server check: fix anything marked ✕.
- Purchase code: keep the detected Site address (
http://127.0.0.1:8000) and enter your code. The modules are downloaded; the code isn't attached to the local address. - Site and database: host
127.0.0.1, port5432, databasereplora, userreploraand its password. - Admin account: your name, email and a password of at least 10 characters.
Or install from the terminal (in a second window while the server runs, or before starting it):
bash
php artisan replora:install --url=http://127.0.0.1:8000 --purchase-code=YOUR-CODE \
--db-database=replora --db-username=replora --db-password=secret \
--admin-name="Alex Morgan" [email protected] --admin-password='a-long-password'Start the worker and the scheduler
Recordings appear only when a worker processes them. Open two more terminals in the application folder:
bash
php artisan queue:work # processes recordings, alerts, announcements
php artisan schedule:work # runs the scheduled tasks every minute (instead of cron)Or, for a quick try without a worker, set QUEUE_CONNECTION=sync in .env: each batch is then processed while the browser waits.
More than one request at a time
PHP's built-in server answers one request at a time, so the dashboard and a recorded page can wait for each other. Add PHP_CLI_SERVER_WORKERS=4 to .env and start php artisan serve again to serve four requests in parallel.
Record a test page
Add a website in the dashboard (its domain can be localhost) and copy its snippet:
html
<script async src="http://127.0.0.1:8000/t.js" data-site="YOUR-SITE-KEY"></script>Put it into any page served from your computer (another local project, or a plain HTML file served with php -S 127.0.0.1:8080), browse it, and the session appears under Session recordings within seconds.
What doesn't work locally
- Websites on the internet can't reach
127.0.0.1: record only pages on your own computer. - Pages served over https can't load a script from an http address (browsers block mixed content).
- On the System page, the Website and Tracking script checks say Not checked on the development server, and SSL certificate says Not used: the site runs on http on this computer. That is expected.
Change the address later
The address is saved in .env as APP_URL, and sign-in works only on that address:
ini
APP_URL=http://127.0.0.1:8010
SANCTUM_STATEFUL_DOMAINS=127.0.0.1:8010,localhost:8010,[::1]:8010Then run php artisan config:clear and start the server on the new port. Snippets you already pasted point at the old address: copy them again.
Moving the copy to a real server
A local copy can become your production site: copy the folder (with storage/ and .env) and dump and restore the database as in Backups & moving servers, then change APP_URL to the real address. The license is attached to the real domain the first time the code is checked there (an update that brings new modules, php artisan replora:core, or the License card on the System page).
