Installation

Basic setup

This is currently assuming Ubuntu 22.04. Get in touch if you're trying on a different OS!

If you have problems with this, the CircleCI config.yml file is a good reference.

Prerequisites

• php v8.2
  • php-curl
  • php-mysql
  • php-xml
  • php-xmlrpc
  • php-intl
• mysql/mariadb
  • and create a database:
    • CREATE DATABASE restarters_db_test
  • add users:
    • CREATE USER 'restarters'@'localhost' IDENTIFIED BY 's3cr3t';
    • CREATE USER 'tester'@'localhost' IDENTIFIED BY 'tester';
  • give users permissions:
    • GRANT ALL PRIVILEGES ON restarters_db_test.* TO 'restarters'@'localhost';
    • GRANT ALL PRIVILEGES ON restarters_db_test.* TO 'tester'@'localhost';
  • load timezone info:
    • mysql_tzinfo_to_sql /usr/share/zoneinfo | mysql -u root mysq
• node v18.14.0
• npm v9.3.1

Install

• Clone this repository

• Copy .env.example -> .env

• Edit .env

  • update DB settings to match your local DB

• Edit /etc/hosts -> 127.0.0.1 restarters.test talk.restarters.test

• php composer.phar install

• npm install

• Generate an app key: php artisan key:generate

• Initialise the DB:

$ php artisan migrate

• Create a first admin user

$ php artisan tinker
> User::create(['name'=>'Jane Bloggs','email'=>'[email protected]','password'=>Hash::make('passw0rd'),'role'=>2]);

• Create a folder for image uploads: mkdir public/uploads
• Run the app:

$ php artisan serve --host=restarters.test

• Login!