A quick fix has been released for RAWeb , RetroAchievements.org ‘s platform for achievements, game data, and community features.

The application, developed with Laravel (TALL stack) , allows users to interact with the RetroAchievements system to track their progress in games and share it with other members of the community.

https://platform.twitter.com/embed/Tweet.html?creatorScreenName=Checcolin80&dnt=true&embedId=twitter-widget-0&features=eyJ0ZndfdGltZWxpbmVfbGlzdCI6eyJidWNrZXQiOltdLCJ2ZXJzaW9uIjpudWxsfSwidGZ3X2ZvbGxvd2VyX2NvdW50X3N1bnNldCI6eyJidWNrZXQiOnRydWUsInZlcnNpb24iOm51bGx9LCJ0ZndfdHdlZXRfZWRpdF9iYWNrZW5kIjp7ImJ1Y2tldCI6Im9uIiwidmVyc2lvbiI6bnVsbH0sInRmd19yZWZzcmNfc2Vzc2lvbiI6eyJidWNrZXQiOiJvbiIsInZlcnNpb24iOm51bGx9LCJ0ZndfZm9zbnJfc29mdF9pbnRlcnZlbnRpb25zX2VuYWJsZWQiOnsiYnVja2V0Ijoib24iLCJ2ZXJzaW9uIjpudWxsfSwidGZ3X21peGVkX21lZGlhXzE1ODk3Ijp7ImJ1Y2tldCI6InRyZWF0bWVudCIsInZlcnNpb24iOm51bGx9LCJ0ZndfZXhwZXJpbWVudHNfY29va2llX2V4cGlyYXRpb24iOnsiYnVja2V0IjoxMjA5NjAwLCJ2ZXJzaW9uIjpudWxsfSwidGZ3X3Nob3dfYmlyZHdhdGNoX3Bpdm90c19lbmFibGVkIjp7ImJ1Y2tldCI6Im9uIiwidmVyc2lvbiI6bnVsbH0sInRmd19kdXBsaWNhdGVfc2NyaWJlc190b19zZXR0aW5ncyI6eyJidWNrZXQiOiJvbiIsInZlcnNpb24iOm51bGx9LCJ0ZndfdXNlX3Byb2ZpbGVfaW1hZ2Vfc2hhcGVfZW5hYmxlZCI6eyJidWNrZXQiOiJvbiIsInZlcnNpb24iOm51bGx9LCJ0ZndfdmlkZW9faGxzX2R5bmFtaWNfbWFuaWZlc3RzXzE1MDgyIjp7ImJ1Y2tldCI6InRydWVfYml0cmF0ZSIsInZlcnNpb24iOm51bGx9LCJ0ZndfbGVnYWN5X3RpbWVsaW5lX3N1bnNldCI6eyJidWNrZXQiOnRydWUsInZlcnNpb24iOm51bGx9LCJ0ZndfdHdlZXRfZWRpdF9mcm9udGVuZCI6eyJidWNrZXQiOiJvbiIsInZlcnNpb24iOm51bGx9fQ%3D%3D&frame=false&hideCard=false&hideThread=false&id=1905227535949980127&lang=it&origin=https%3A%2F%2Fwww.biteyourconsole.net%2F2025%2F03%2F31%2Fpubblicato-un-nuovo-aggiornamento-correttivo-per-raweb%2F&sessionId=312182a51706fb631650e0634c4b2bb6efc6c427&siteScreenName=BiteYourConsole&theme=light&widgetsVersion=2615f7e52b7e0%3A1702314776716&width=550px

This release introduces bug fixes, including a crash issue in CSV input for similar games, performance improvements in handling achievement queries, and a fix for how line breaks and carriage returns are handled in emails.

Additionally, a command has been added to convert event games to event records.

Requirements

To run RAWeb locally, you need the following components:

Local Web Server : A web server is required to run the application.
PHP 8.2 : The platform requires PHP 8.2, with several extensions enabled (such as curl, gmp, mysqli, pdo_mysql, gd, intl, sockets).
Composer : The PHP dependency manager, needed to install the libraries required by RAWeb.
MariaDB 10 : The supported database to store data.
Node.js 20 and pnpm 9 : These tools are used for frontend package management and asset building.

RAWeb is compatible with the following operating systems and configurations:

Windows, macOS, Linux .
Several configuration options are available: Docker (with Laravel Sail), XAMPP and Laravel Valet for macOS.

Configuration options

There are several options for configuring RAWeb :

Docker Compose (Windows, Linux, macOS):
Using Laravel Sail , the development environment is automatically created with Docker containers. The Laravel Sail documentation describes the detailed steps. Once configured, you can start the containers with the command sail upor in daemon mode with sail up -d.
XAMPP (Windows, Linux, macOS):
You need to install XAMPP with PHP 8.2, which includes an Apache server, MySQL/MariaDB and PHP. You will need to enable some extensions in php.ini(such as curl, gmp, , etc.) to ensure compatibility with RAWebmysqli dependencies .
Laravel Valet (macOS):
If you are using Laravel Valet on macOS, you can easily set up your local environment. Valet acts as a driver for your development environment and provides a hassle-free local web setup.

Installing RAWeb

Once the server and dependencies are configured, installing RAWeb occurs in two main phases:

Installing Dependencies : After cloning the RAWeb repository , run composer installto install all the necessary libraries. If you want to use the local version of composer.phar instead of a global one, you can run php composer.phar install.
Environment Setup : You need to run the command composer setupto properly setup the environment. This script will set up the environment variables and initial configurations. During this step, it is recommended to adapt the file .envwith the database credentials and the application URL.

Environment configuration (.env)

The file .envcontains sensible default values, but some changes may be needed:

Database Credentials : Set the values for connecting to the local database (DB_*).
Configuring the application URL : Set the application URL ( APP_URL). For example, if you are using Docker , the URL might be http://localhost:64000. With Valet , it might be https://raweb.test.

If you are using a Docker environment, no further specific configuration is required, as the application will automatically detect the Laravel Sail container configuration.

If you are using XAMPP or Valet, you will need to adjust your application URL and configure your virtual hosts or domain correctly.

Frontend construction and configuration

To generate frontend assets:

Installing Frontend Dependencies : Use pnpm installto install the necessary dependencies.
Asset Building : Run pnpm buildto create the final build. With Docker Sail , you can run these commands via sail pnpm installand sail pnpm build.
Creating symlinks for the filesystem : To make the storage files accessible, run php artisan ra:storage:link --relativeto create the necessary symbolic links. This command is also available via Sail ( sail artisan ra:storage:link --relative).

Database configuration

After you have configured the environment and built the assets, you need to prepare the database:

Run Migration : Run php artisan migrateto apply migrations and configure the database.
Populate database with test data : Use the command php artisan db:seedto populate the database with test data. You can also run this command via Sail ( sail artisan db:seed).

Access to the application

Depending on the environment you choose, you can access the application as follows:

Docker : http://localhost:64000
XAMPP – Based on Apache vhost configuration.
Laravel Valet : for example, https://raweb.test , depending on your domain configuration.

Use for goal development

If you want to develop targets locally, you can add a file in the RALibRetrohost.txt directory next to the RAIntegration.dll file . This file should contain the URL of your local server, which could be one of the following:

http://localhost:64000 if you are running the server via Docker.
https://raweb.test if you are using Valet .
http://raweb.test if the vhost is configured correctly.

Safety

To address any security vulnerabilities, please review RetroAchievements.org’s Security Policy , which provides guidance on how to manage risks and secure the platform.

This way, you can configure and use RAWeb to manage achievements, games, and community features directly from your local server.