{"id":18683579,"url":"https://github.com/scify/volunteasy","last_synced_at":"2026-01-25T21:21:25.493Z","repository":{"id":31581009,"uuid":"35145783","full_name":"scify/VoluntEasy","owner":"scify","description":null,"archived":false,"fork":false,"pushed_at":"2017-11-24T12:08:47.000Z","size":130259,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":7,"default_branch":"master","last_synced_at":"2025-05-18T17:14:23.455Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"HTML","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/scify.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE.TXT","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2015-05-06T07:41:34.000Z","updated_at":"2020-06-04T18:05:58.000Z","dependencies_parsed_at":"2022-09-09T20:51:35.361Z","dependency_job_id":null,"html_url":"https://github.com/scify/VoluntEasy","commit_stats":null,"previous_names":[],"tags_count":2,"template":false,"template_full_name":null,"purl":"pkg:github/scify/VoluntEasy","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scify%2FVoluntEasy","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scify%2FVoluntEasy/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scify%2FVoluntEasy/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scify%2FVoluntEasy/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/scify","download_url":"https://codeload.github.com/scify/VoluntEasy/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/scify%2FVoluntEasy/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28758931,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-25T20:56:06.009Z","status":"ssl_error","status_checked_at":"2026-01-25T20:54:48.203Z","response_time":113,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-07T10:14:58.733Z","updated_at":"2026-01-25T21:21:25.475Z","avatar_url":"https://github.com/scify.png","language":"HTML","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Volunteasy\n\n### Starting the project\n\nFor installing Laravel, please refer to [Official Laravel installation\nguide](http://laravel.com/docs/5.1).\n\nCheck the server eequirements of the version in the project, install and enable the required php modules.\n\n### Installing dependencies (assuming apache as web server and mysql as db):\n\nIn a nutshell (assuming debian-based OS), first install the dependencies needed:\n\nNote: php5 package installs apache2 as a dependency so we have no need to add\nit manually.\n\n`% sudo aptitude install php5 php5-cli mcrypt php5-mcrypt mysql-server php5-mysql`\n\nInstall composer according to official instructions (link above) and move binary to ~/bin:\n\n`% curl -sS https://getcomposer.org/installer | php5 \u0026\u0026 mv composer.phar ~/bin`\n\nDownload Laravel installer via composer:\n\n`% composer global require \"laravel/installer=~1.1\"`\n\nAnd add ~/.composer/vendor/bin to your $PATH. Example:\n\n```\n% cat ~/.profile\n[..snip..]\nLARAVEL=/home/username/.composer/vendor\nPATH=$PATH:$LARAVEL/bin\n```\n\nAnd source your .profile with `% source ~/.profile`\n\nAfter cloning the project with a simple `git clone https://github.com/scify/VoluntEasy.git`, type `cd VoluntEasy/VoluntEasy \u0026\u0026 composer install` to install all dependencies.\n\n### Editing the .env file\n\nCopy the existing `VoluntEasy/.env.example` file to `VoluntEasy/.env`.\n\nFirst, you have to generate an application key. Use `php artisan key:generate`.\n\nAn example .env file should look like this (populate it using your own credentials):\n\n```\nAPP_DEBUG=false\nAPP_KEY=generatedkeygoeshere\n\nDB_HOST=localhost\nDB_DATABASE=volunteasy\nDB_USERNAME=volunteasy\nDB_PASSWORD=secretpass\n\nCACHE_DRIVER=file\nSESSION_DRIVER=file\nQUEUE_DRIVER=sync\n\nMAIL_DRIVER=smtp\nMAIL_HOST=smtp.mailtrap.io\nMAIL_PORT=2525\nMAIL_USERNAME=username\nMAIL_PASSWORD=mailpassword\nMAIL_FROM_ADDR=hello@example.com\nMAIL_FROM_NAME=Name\n\nLOCALE=el\n\nMODE=municipality\nROOT_URL=http://volunteasy.example.com\n```\n\n### Apache configuration:\n\n```\n% cat /etc/apache2/sites-available/mysite.conf\n\u003cVirtualHost *:80\u003e\n\tServerName myapp.localhost.com\n\tDocumentRoot \"/path/to/VoluntEasy/VoluntEasy/public\"\n\t\u003cDirectory \"/path/to/VoluntEasy/VoluntEasy/public\"\u003e\n\t\tAllowOverride all\n\t\u003c/Directory\u003e\n\u003c/VirtualHost\u003e\n```\n\nMake the symbolic link:\n\n`% cd /etc/apache2/sites-enabled \u0026\u0026 sudo ln -s ../sites-available/mysite.conf`\n\nEnable mod_rewrite and restart apache:\n\n`% sudo a2enmod rewrite \u0026\u0026 sudo service apache2 restart`\n\nFix permissions for storage directory:\n\n`% chmod -R 755 path/to/VoluntEasy/VoluntEasy/storage \u0026\u0026 chown -R www-data:www-data /path/to/VoluntEasy/VoluntEasy/storage`\n\nTest your setup with:\n\n`% php artisan serve`\n\nand navigate to localhost:8000.\n\n\n### Nginx configuration:\n\nAdd additional the additional dependencies needed:\n\n`% sudo aptitude install nginx php5-fpm`\n\nDisable cgi.fix_pathinfo at /etc/php5/fpm/php.ini: `cgi.fix_pathinfo=0`\n\n`% sudo php5enmod mcrypt \u0026\u0026 sudo service php5-fpm restart`\n\nNginx server block:\n\n```\nserver {\n    listen 80 default_server;\n    listen [::]:80 default_server ipv6only=on;\n\n    root /var/www/laravel/public;\n    index index.php index.html index.htm;\n\n    server_name server_domain_or_IP;\n\n    location / {\n        try_files $uri $uri/ /index.php?$query_string;\n    }\n\n    location ~ \\.php$ {\n        try_files $uri /index.php =404;\n        fastcgi_split_path_info ^(.+\\.php)(/.+)$;\n        fastcgi_pass unix:/var/run/php5-fpm.sock;\n        fastcgi_index index.php;\n        fastcgi_param SCRIPT_FILENAME $document_root$fastcgi_script_name;\n        include fastcgi_params;\n    }\n}\n```\n\n`% sudo service nginx restart \u0026\u0026 sudo chmod -R 755 path/to/project/storage`\n\nAnd finally, set the group appropriately:\n\n`% sudo chown -R www-data:www-data storage`\n\n### Database\n\n#### Creating a new database\n\nInitialize the database with `php artisan migrate` and test the installation with `php artisan serve` and hit `localhost:8000/auth/register` at your browser of choice.\n\nAfter running migrations, it's time to create an initial user.\n\nNavigate at the root directory and run `./config-user.pl`. The script asks for initial user info. After filling everything, you will be asked if the info is correct. If not, just press `n` and it will run once more. Upon successful completion, the database seed file will be generated. It's time to seed the database with `php artisan db:seed --class=UserTableSeeder`.\n\n\nTry login credentials by navigating at http://localhost/auth/login\n\n#### Importing the demo database\n\nIf you want, you may try to import the .sql file into your database instead of\ncreating a new one. Just enter `mysql -u user -p database_name \u003c project_voldemo.sql`.\n\nCredentials for the root user are:\n\n```\nuser:\tdemo@scify.org\npass:\tdemo1234\n```\n\n### Command scheduling\n\nAs of now, a background job performs a search for actions that are going to expire in seven days and sends a questionnaire link to all the subscribed volunteers. While the job exists, because it resides on `artisan`, you will need to add a cronjob entry for this.\nSomething like\n```\n% crontab -l\n0 1 * * * php /path/to/artisan schedule:run 1\u003e\u003e /dev/null 2\u003e\u00261\n```\nwill suffice.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscify%2Fvolunteasy","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fscify%2Fvolunteasy","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fscify%2Fvolunteasy/lists"}