Setting up a new Drupal 8 site on amazee.io using the Composer project template (Mac OS)

I’ve setup quite a few existing Drupal 7 websites, but setting up a brand new Drupal 8 site is a little different as you can do so from the Composer template and save lots of time. Although it is possible to run Drupal 8 sites without Composer, I strongly suggest you use it.

  • install composer if you don’t already have it installed
  • composer create-project amazeeio/drupal-project:8.x-dev SITENAME dev--no-interaction
  • create your git repository & make your first push
  • customise .amazeeio.yml by adding your sitegroup
  • customise docker-compose.yml by adding your sitename
  • If you don’t already have them installed, install Homebrew, Docker, Docker Machine, Docker Compose, Amazee Cachalot & Virtual Box. Full instructions here
  • amazeeio-cachalot up
  • docker-compose up -d
  • docker-compose exec --user drupal drupal bash
  • install your drupal site with drush si
  • type url then cmd+click to open the URL in your browser
  • at this point, I usually change the default config folder from web/sites/default/config to config. To do this, edit web/sites/default/all.settings.php and change the path to ../config/sync.
  • continue configuring your site. To add new drupal modules, open a new terminal tab, staying in the docroot, then use commands such ascomposer require drupal/PROJECT-NAME
  • Grant the amazee.io team access to your repo
  • Inform the amazee.io team that you would like them to finish configuring your site
  • Once they’re done, you will be able to push your database & files from your local to dev/test/master sites