Overview
Setup
Connect to the VPN before proceeding with the following steps.
Change Region
Before diving into troubleshooting, make sure you have followed the setup instructions provided in the README file on the GitHub repository. These steps include installing and configuring the Laravel website. Ensure that you have completed all the necessary setup procedures before proceeding with troubleshooting.
For changing the region you can run the following command in the terminal
php artisan region:change
The above command will prompt you to enter the region name. Enter the region name and press enter.
Update environment variables
- After changing the region, ensure that you update the following environment variables in your
.envfile:
| Variable | Value | Description |
|---|---|---|
APP_HOST | localhost | Host variable set to avoid session issues. Learn more. |
CUSTOMER_JWT_EXPIRY_TIME | 3600 | JWT expiry time for customer sessions (1 hour). |
SESSION_JWT_EXPIRY_TIME | 3600 | JWT expiry time for general sessions (1 hour). |
Troubleshooting
For detailed error messages, check the
laravel.logfile.
- Error:
The cookie expiration time is not valid.- Navigate to
<folder>/website/config/toolstattion/trolleys.phpand look forcookiesarray and comment out thelifetimekey
'cookie' => [ 'name' => 'ToolstationV5', 'regex' => '/[a-z0-9]{32,64}/i', 'length' => 64, //'lifetime' => 315360000, ] - Navigate to
- Error:
Our website is currently undergoing maintenanceappears when attempting to access the site.- Ensure that both the MASTER
MASTER_DB_HOSTand SLAVE database hostsSLAVE_DB_HOSTSare reachable by verifying in.envfile. - Confirm the accuracy of the database credentials.
- Ensure that both the MASTER
- Error:
Cache MissFor Windows- Navigate toXampp > config > php.ini- Update the
max_execution_timeandmemory_limitvalues to avoid timeouts and memory peaks. - Restart the Apache server.