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

Chandeep Khosa
Jul 29, 2017 · 3 min read

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 some-dir --stability 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

Chandeep Khosa

Written by

Freelance #Drupal 8 & Front End Developer | #Drupal8 Core contributor | Organiser @DrupalWLondon

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch
Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore
Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade