Muster is a web application for UKRDA Member Leagues and administration staff to manage the process of digitised charter submission.
Muster is built on a vanilla install of Laravel 5, with the addition of a couple of external packages:
A composer configuration is included to build the base environment, but the composer phar has not been included directly.
The process for getting an instance of Muster up and running is a bit manual for now, unfortunately. I presume some (or all) of this can be shortened/automated, but have put zero effort into investigation and thus manual is all we have until there's more urgency for better.
Steps are as follows:
install and configure a hosting environment suitable for Laravel 5. The Laravel 5 documentation has all the information you need to get going
clone the canonical repo into a folder of your choosing
jump into the root directory of the project and run
.envin the same directory, and edit to taste
make sure that the
storagedirectory (and any of it's contents) are writable by the user your httpd process runs under (eg. www-data in Ubuntu, http in Arch Linux, etc)
php artisan migratefrom the command line (protip: make the artisan file executable and you can just run
php artisan db:seedfrom the command line (or
./artisan db:seedif you did the protip above)
manually inject a user record into the database. In MariaDB/MySQL this looks like:
INSERT INTO `users` (`id`, `name`, `email`, `password`, `created_at`, `updated_at`) VALUES (1, 'root', 'firstname.lastname@example.org', '$2y$10$BK7HykL2gNqMW9aWDZ9qr.c.dca6XQmpNLbyBA7nb5QUz3xWd7xHW', NOW(), NOW() );
manually marry the injected user with the
rootpermission role. Again, in MariaDB/MySQL this looks like:
INSERT INTO `role_user` (`user_id`, `role_id`) VALUES (1, 1);
fire up your browser and direct it to your new Muster instance
log in with the credentials:
email address: root@localhost password: d6c75196
immediately change your password for this user account, or create a new root account and delete the temporary one