RAWeb is RetroAchievements.org's platform application. It is a Laravel application (TALL stack) including individual php files within the public folder to handle requests.

• Local web server
• PHP 8.0
• Composer v2 PHP dependency manager
• MySQL 8
• Node.js 18

Validated to run on Windows, macOS, and Linux with any of the setup options below (Docker via Laravel Sail, VM with either nginx or Apache, Laravel Valet on macOS).

See Laravel Sail documentation.

Install the XAMPP version packaged with PHP 8.0 to run an Apache web server, MySQL/MariaDB, and PHP on your system.

You might have to enable some extensions in php.ini (see the ext-* requirements in composer.json):

extension=curl
extension=gmp
extension=mysqli
extension=pdo_mysql
extension=gd
extension=intl
extension=sockets

A local valet driver is provided.

composer install

composer setup

Note In case you want to rely on the shipped composer.phar instead of a global installation read all mentions of composer within commands as php composer.phar. I.e. run php composer.phar setup if you haven't aliased it.

The environment configuration file (.env) contains a sensible set of default values.

Docker/Laravel Sail

No additional configuration is needed; the configuration automatically detects whether it's running the application via the Laravel Sail application container and adjusts hosts and ports accordingly.

However, you might want to adjust the forwarded container port numbers to your liking (APP_PORT, FORWARD_*).

Now is a good time to create the containers. Sail forwards commands to Docker Compose:

sail up
# Daemonize:
sail up -d

Note Mentions of sail commands assume that it has been aliased to the ./vendor/bin/sail executable according to Sail's docs. I.e. run ./vendor/bin/sail up if you haven't aliased it.

XAMPP/Valet

Adjust the local environment configuration (.env):

• Enter the credentials of your local database instance (DB_*)
• Change the application URL (APP_URL) - static assets URL (ASSET_URL) should be the same as APP_URL

Note APP_URL varies depending on your setup. By default it's configured to use the forwarded application Docker container port. E.g. using an Apache vhost or linking a domain via Laravel Valet this should be adjusted accordingly:

APP_URL=https://raweb.test
ASSET_URL=https://raweb.test

Hybrid Docker setup

When running the application locally (i.e. web server and PHP via XAMPP/Valet) it's possible to use the provided Docker services, too.

Use database and redis services:

DB_PORT=${FORWARD_DB_PORT}
REDIS_PORT=${FORWARD_REDIS_PORT}

Note Connect with a database client of you choice using the forwarded ports or use phpMyAdmin which runs at http://localhost:64080 by default.

Use mailhog as SMTP server for local mails testing:

MAIL_MAILER=smtp

Note Runs at http://localhost:64050 by default.

Use minio as an AWS S3 drop-in replacement:

AWS_MINIO=true

Note In order to use S3 features you'll have to create a local bucket manually first. Runs at http://localhost:64041/buckets/add-bucket by default.

npm install
npm run build
# Using Sail:
sail npm install
sail npm run build

php artisan ra:storage:link --relative
# Using Sail:
sail artisan ra:storage:link --relative

php artisan migrate
# Using Sail:
sail artisan migrate

Seed your database with additional test data:

php artisan db:seed
# Using Sail:
sail artisan db:seed

Depending on the setup you chose the application should run.

• Docker: http://localhost:64000
• XAMPP: depending on Apache vhost configuration
• Laravel Valet: e.g. https://raweb.test - depending on link / parked location and whether you chose to secure it or not

Add a host.txt file next to RAIntegration.dll in your local RALibRetro's directory. The file should contain the URL to your local RAServer instance. Any of the following will work:

• http://localhost:64000 when running the server via Docker, composer start or artisan serve.
• https://raweb.test (example) when running the server via Valet
• http://raweb.test (example) as a configured vhost

If you discover a security vulnerability, please send an on-site message to RAdmin.

See Contribution Guidelines and Code of Conduct.

RAWeb is open-sourced software licensed under the GPL-3.0 License.

Console Icons by yspixel.jpn.org and Tatohead.