Skip to content

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.

10 minutesSite owners, developersCommand lineSingle user · SaaS

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 replora
bash
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-alpine

On 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 serve

php 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:

  1. Server check: fix anything marked ✕.
  2. 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.
  3. Site and database: host 127.0.0.1, port 5432, database replora, user replora and its password.
  4. 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]:8010

Then 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).

Replora: see what your visitors see.