VPS Installation.

If you plan to use a machine from Digital Ocean / Vultr ETC.

---

Step-by-Step Installation Instructions for Betn on a VPS

Before you start. Login into your new webserver/vps using bash, cmd, or Terminal.

Prerequisites: Install the the following.

1. LAMP Stack: Make sure you have a LAMP (Linux, Apache, MySQL, PHP) server setup. This setup includes: (Server Requirements for full list)

   • Linux (Ubuntu or CentOS, for instance)

   • Apache web server

   • MySQL 8.0 database server (or MariaDB, depending on your preference)

   • PHP 8.2 or later (preferably the latest version compatible with Betriver)

2. Composer and Node.js/NPM installed on your server:

   • Composer: A dependency manager for PHP, required to install PHP packages.

   • Node.js and NPM: Node Package Manager, required for frontend assets.\

Detailed Steps:

1. Set Up Your Web Root:

   • Point your Apache web server’s DocumentRoot to the public directory inside your site directory.

   • Example for Apache configuration for betriver.io site.

   • (/etc/apache2/sites-available/betriver.io.conf):

     <VirtualHost *:80>
         ServerName betriver.io
         DocumentRoot /var/www/betriver.io/public
         
         <Directory /var/www/betriver.io/public>
             AllowOverride All
             Require all granted
         </Directory>
     
         ErrorLog ${APACHE_LOG_DIR}/betriver.io-error.log
         CustomLog ${APACHE_LOG_DIR}/betriver.io-access.log combined
     </VirtualHost>

2. After updating this file, enable the site and restart Apache:

   sudo a2ensite betriver.io.conf
   sudo systemctl reload apache2

3. Extract the Application Files:

   • Upload Betriver-vps.zip to your /var/www/ directory.

   • Extract the zip file:

     sudo unzip Betriver-vps.zip -d /var/www/

   • Rename the extracted folder to your site name, for example:

     sudo mv /var/www/Betriver /var/www/betriver.io

4. Navigate to the Site Directory:

   • Change directory to your newly created site folder:

     cd /var/www/betriver.io

5. Install PHP Dependencies:

   • Run Composer to install the necessary PHP packages:

     composer install

   • This will create a vendor directory containing all the required PHP packages.

6. Set Up Frontend Assets:

   • Run NPM to build frontend assets:

     npm install
     npm run production

7. Configure Environment Variables:

   • rename the env.file file to .env:

     cp .env.file .env

   • Update .env with your database and other configuration details:

     DB_CONNECTION=mysql
     DB_HOST=127.0.0.1
     DB_PORT=3306
     DB_DATABASE=your_database_name
     DB_USERNAME=your_database_user
     DB_PASSWORD=your_database_password

8. Generate Application Key:

   • Run the following command to generate a unique application key:

     php artisan key:generate

9. Run Database Migrations and Seeders:

   • Migrate the database tables and seed initial data:

     php artisan migrate --seed

10. Set Folder Permissions:

    • Ensure the necessary permissions for the storage and bootstrap/cache directories:

      sudo chmod -R 775 storage bootstrap/cache
      sudo chown -R www-data:www-data storage bootstrap/cache

11. Restart Apache:

    • Finally, restart Apache to ensure all configurations are correctly applied:

      sudo systemctl restart apache2

12. Access the Site:

    • Open your browser and navigate to your site’s URL (e.g., http://betriver.io). Your site should now be live!

13. Clean up and fix a few things.

    • If you are like me , you most likely use root, so some permission maybe messed up.

      # Clean up
      mkdir -p storage/app/public/uploads/
      php artisan clear-compiled
      php artisan optimize
      php artisan storage:link
      sudo chgrp -R www-data storage bootstrap/cache
      sudo chmod -R ug+rwx storage bootstrap/cache

Open your browser and navigate to your site’s URL (e.g., http://betriver.io). Your site should now be live!

Configure CRON

Option 1: Using Crontab

1. Open your crontab file:

Copy

crontab -u www-data -e

1. Add this line to run the scheduler every minute:

Copy

* * * * * cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1

Replace /path-to-your-project with your project path. (Not the public directory)

Option 2: Using System Crontab

1. Create a new file in /etc/cron.d/:

Copy

sudo nano /etc/cron.d/laravel-scheduler

1. Add the following line:

Copy

* * * * * www-data cd /path-to-your-project && php artisan schedule:run >> /dev/null 2>&1

1. Set proper permissions:

Copy

sudo chmod 644 /etc/cron.d/laravel-scheduler

SETUP LARAVEL REVERB.

You need to setup supervisor to run and monitor laravel reverb. We include a bash script to get you up and running without having to manually setup everything. make sure you are in your site directory. This will rig and start all the supervisor processes needed to get reverb up and running. correctly

Copy

#cd to your site directory EG.cd /var/www/betriver.com
cd /var/www/betriver.io
chmod +x laravel-reverb-setup.sh
sudo bash ./laravel-reverb-setup.sh

---

Update .env

Copy

#update REVERB_HOST with your plain domain.
#Donot add a slash after or http(s). eg scriptoshi.com, betriver.website.com etc
REVERB_HOST="scriptoshi.com"

Laravel Queue Workers.

The app users queues for events for Jobs, Events and Notification. Queue workers are monitored by supervisord. We have created bash script that will configure supervisord to monitor your queues. here's how to run it.

Copy

#cd to your site directory EG.cd /var/www/betriver.com
cd /var/www/betriver.com
chmod +x queue-worker-setup.sh
sudo bash./queue-worker-setup.sh

---