This is a sample vanilla Drupal 8 installation pre-configured for use with Docksal.
Features:
- Vanilla Drupal 8
fin init
example- Using the default Docksal LAMP stack with image version pinning
- PHP and MySQL settings overrides examples
- Drush aliases example (
drush @docksal status
)
This is a one time setup - skip this if you already have a working Docksal environment.
Follow Docksal environment setup instructions
-
Clone this repo into your Projects directory
git clone https://github.com/docksal/drupal8.git drupal8 cd drupal8
-
Initialize the site
This will initialize local settings and install the site via drush
fin init
-
Point your browser to
http://drupal8.docksal
When the automated install is complete the command line output will display the admin username and password.
Site provisioning can be automated using fin init
, which calls the shell script in .docksal/commands/init.
This script is meant to be modified per project. The one in this repo will give you a good starting example.
Some common tasks that can be handled by the init script (an other custom commands):
- initialize local settings files for Docker Compose, Drupal, Behat, etc.
- import DB or perform a site install
- compile Sass
- run DB updates, revert features, clear caches, etc.
- enable/disable modules, update variables values
This repo is intended for quick start demos and includes a hardcoded value for hash_salt
in settings.php
.
If you are basing your project code base on this repo, make sure you regenerate and update the hash_salt
value.
A new value can be generated with drush ev '$hash = Drupal\Component\Utility\Crypt::randomBytesBase64(55); print $hash . "\n";'