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 .env file:
VariableValueDescription
APP_HOSTlocalhostHost variable set to avoid session issues. Learn more.
CUSTOMER_JWT_EXPIRY_TIME3600JWT expiry time for customer sessions (1 hour).
SESSION_JWT_EXPIRY_TIME3600JWT expiry time for general sessions (1 hour).

Troubleshooting

For detailed error messages, check the laravel.log file.

  • Error: The cookie expiration time is not valid.
    • Navigate to <folder>/website/config/toolstattion/trolleys.php and look for cookies array and comment out the lifetime key
       'cookie' => [
          'name' => 'ToolstationV5',
          'regex' => '/[a-z0-9]{32,64}/i',
          'length' => 64,
          //'lifetime' => 315360000,
      ]
    
  • Error: Our website is currently undergoing maintenance appears when attempting to access the site.
    • Ensure that both the MASTER MASTER_DB_HOST and SLAVE database hosts SLAVE_DB_HOSTS are reachable by verifying in .env file.
    • Confirm the accuracy of the database credentials.
  • Error: Cache Miss
    • For Windows - Navigate to Xampp > config > php.ini
    • Update the max_execution_time and memory_limit values to avoid timeouts and memory peaks.
    • Restart the Apache server.

Copyright © 2026