Installing on the server

Q: Blank page or error 500 after installing

Look in storage/logs/. It is almost always a write permission on storage/ or a missing PHP extension.

Q: I want to reinstall from scratch

Delete config/installed.lock and the .env file, empty the database and open /install/ again. The same licence works for the same domain.

The web wizard does all the work in nine screens. No command line needed: upload the files, create the database and follow the steps.

Uploading the files

Unzip the package. Inside there is a single folder, sysrevai/.
Upload it whole to the server (SFTP, the hosting file manager or scp).
Point the site’s document root at sysrevai/public. In CloudPanel, Plesk or cPanel it is a site option; in Nginx or Apache, one line in the vhost.
Make sure PHP can write to storage/ and public/uploads/.

The wizard, step by step

Step	What it does	What to have ready
1 · Requirements	Checks PHP, extensions, permissions and memory.	Nothing. Fix anything that fails and re-check.
2 · Dependencies	Verifies the bundled libraries are present.	Nothing: the ZIP ships them.
3 · Database	Tests the connection and, if you want, creates the database.	MySQL host, name, user and password.
4 · Tables	Creates every table and the defaults.	Nothing. A few seconds.
5 · General settings	Site name, URL, default language, time zone, HTTPS.	The site’s final URL.
6 · Administrator	Creates the first account (owner).	An e-mail and a strong password.
7 · Licence	Validates the key with sysrevai.com and registers the domain. Mandatory.	The licence number.
8 · Finish	You accept the SysRevAI Privacy Policy and Terms of Use (linked to sysrevai.com); it writes the `.env` file, creates the administrator and seals the installer. At the end it shows the cron line for this server.	Read and accept the terms.

After installing

The cron job is essential. Add a cron that runs php /path/sysrevai/bin/worker.php every minute as the web site user. Without it there are no automatic backups, article retrieval and download, scheduled searches, long AI jobs or update checks. The installer gives you the exact line at the end and, while it is not running, administrators see an amber bar on every page with a “How to set up the cron job” button that leads to Admin → Maintenance → Scheduled tasks (cron): the line to copy, the steps over SSH or with a control panel (CloudPanel, Plesk, cPanel) and the status. Once the cron runs, the card says “Running” and the bar goes away.
Sealed installer. Once finished, /install/ no longer opens. You may delete public/install/ if you prefer.
Backups. Once the cron runs, the platform makes a full backup every 2 hours by itself (chapter 15).

* * * * * php /path/sysrevai/bin/worker.php >> /path/sysrevai/storage/logs/worker.log 2>&1

Common problems

Blank page or error 500 after installing

Look in storage/logs/. It is almost always a write permission on storage/ or a missing PHP extension.

"The licence server could not be reached"

The server has no outbound HTTPS or a firewall blocks sysrevai.com. Check with curl https://sysrevai.com from the server.

An amber bar says “Background tasks are not running”

The cron job is not set up or has stopped. Press “How to set up the cron job” and copy the line shown in Admin → Maintenance → Scheduled tasks into the server’s crontab (crontab -e as the website user) or the control panel’s Cron Jobs section, every minute. Within a minute the bar goes away.

I want to reinstall from scratch

Delete config/installed.lock and the .env file, empty the database and open /install/ again. The same licence works for the same domain.

Did this chapter help? Tell us what is missing via Contact.