A Docksal based local environment for our Drupal contribution days at Microserve.

It includes commonly used Docksal addons, and automates common tasks like cloning Drupal core, generating hash salts, copying and changing settings files and setting up PHPUnit for running automated tests. This should simplify and speed up the setup process, allowing more time for people to focus on contribution tasks.

• Docksal
• Git

1. Clone the repository into your Docksal projects directory (e.g. ~/Projects), specifying the directory name and the Drupal version.

   git clone https://github.com/microserve-io/contribution-day.git --branch 8.7.x drupal87
   

2. Go into the drupal87 directory.

3. Run the fin init command. This will start the Docksal containers, clone the specified version of core, copy in the static files, run composer install and drush site-install.

   Drupal itself will be cloned into a drupal directory. Ensure that you are within this directory when creating patch files.

4. Visit http://drupal87.docksal in your browser.

5. To run automated tests, use the fin phpunit command.

MIT

• Oliver Davies
• All contributors