Up and Running with Drupal 8

(Originally posted on ThinkShout.com)

It’s November 2015, and Drupal.org is rolling out Drupal 8 release candidates! Heck, Drupal 8 is coming out this week. For many devs, that means we need to figure out how to install, sync, and set up a site theme. Here at ThinkShout, learning is part of the job – we have dedicated time every week to learn new things and share them, be it in a blog post, at our weekly engineering meetings, or at our weekly team lunch.

For the last few months, we’ve made learning Drupal 8 our singular focus. The ‘D8 Bookclub’ has been getting assignments, doing their homework, and sharing their findings internally. We’ve now spent enough time with Drupal 8 that we can share what we’ve learned, the little gotchas and hard-to-find code snippets, as well as the general change in philosophy that has occurred in the shift from D7 to D8.

We generally agree that one of the things keeping people from digging into Drupal 8 is the difficulty of getting it installed and running in a deployable way, which is a must-have if you want to have a team working on a project. This article will walk you through Drupal 8 installation and configuration sync. The follow-up article (Up and Theming with Drupal 8) will cover theme setup and configuration, so that you can finally get going with theming in D8.

Installing Drupal 8

The composer install method is being widely proposed as the replacement for drush make. The composer.json file is to composer install what a drush make file is to drush make. The drupal-composer github repo has a composer template called drupal-project that will get us up and running with just the basics necessary to have a working site.

For command-line manipulation, you’ll need to be using Drush 8. Like most dev shops, we use version control (Git) as well as a local->dev->test->live server setup. There are a few gotchas here:

The composer template mentioned above works great for a basic D8 install, but if you want it customized (additional packages, post-install commands, etc), you will have to:

  • download the full composer profile
  • unzip the files
  • update the composer.json and scripts/composer/post-install.sh files
  • run composer install locally.

This is the method we’ll be using for the rest of this post.

First, install composer. We’re using OSX with Homebrew, so this is fairly simple – brew install composer. Note: after implementing this, add this to your .bashrc (or similar):

export PATH="$HOME/.composer/vendor/bin:$PATH"

Next, ensure you have Drush 8 installed. We prefer the Composer global install approach to make updating Drush as simple as running composer global update.

Next, download the full composer profile, and unzip it into an appropriate local directory (We use a ~/Sites/ directory to hold all of our projects).

Note: the Drupal Composer project updates regularly. If you run into any errors, re-download it. You could alternately create an installation profile in the web/profiles folder, but that seems to be a tad under-documented and still not fully baked.

Now that we have a default site scaffold in place, we can get back to the post-install method. If you want to run the site installer after composer installs Drupal, in the post-install.sh file, you would add:

cd web;drush si --site-name="SITENAME" --db-url=mysql://root:PASSWORD@HOSTNAME/DBNAME -y;cd ../

For the above, replace SITENAME, PASSWORD, HOSTNAME(we use localhost) and DBNAME.

One of the D8 Bookclub challenges was completing the installation without any warnings appearing on the Status Reports page at /admin/reports/status. We also want to specify the configuration sync directory, so that it’s not site-unique.

The trick here is to use a series of permission and site config tweaks. After the site install code above, add the following to your post-install.sh:

chmod 777 web/sites/default/s*;

#Prepare the custom sync directory, which will sit outside of the web root
if [ ! -d configs ] then mkdir -m777 configs fi

echo "\$config_directories['sync'] = '../configs';" >> web/sites/default/settings.php

echo "\$settings['trusted_host_patterns'] = array('SITENAME\.dev$',);" >> web/sites/default/settings.php;

chmod 444 web/sites/default/s*;

chmod -R 777 web/sites/default/files;

This will make the settings.php file editable, create a sync directory below the web root (bonus security!), add the sync directory path, add the trusted host pattern (a new D8 requirement), secure the file, and make the web/sites/default/files folder globally writable.

Now you’re ready to run the installation! From the base directory, run:

composer install

This will take a while, since it’s downloading Drupal and all the modules. After initial installation, perform a full export and an immediate import/sync of your site configuration profile. This can be done two ways:

  1. Via the gui: /admin/config/development/configuration/full/exportSave this export file! Any subsequent sites will need this as a starting point so that entity mismatches don’t occur.
  2. Via Drush (run from the /web directory):
drush config-export
drush config-import sync

This will export and then sync all of your config files in the configuration directory we specified in the post-install script.

You would then check in this version of the site – a commit message such as ‘Base Site profile’ would be helpful. Here’s a quick set of command-line git repo creation commands, starting with an installation of hub, the command-line wrapper for GitHub (this will allow you to use GitHub’s 2-factor authentication):

brew install hub
git init 
hub create
git add .
git commit -m 'Base Site profile'
git push --set-upstream origin master

After that, you can check out additional sites by creating a directory, cd into that directory, and running a git clone command inside it, such as:

git clone git@github.com:USER/REPOSITORY.git .

Now you can run composer install to build your clone.

Optional: edit the post-install.sh prior to running composer install if you’d like your clone to have a different hostname, db, etc.

Syncing Sites

Site configurations are only exportable to sites that have the same UUID and have synced using the shared base configuration profile. To find your site’s UUID, cd to the web folder of the base site, then run drush config-get system.site. After that, any new site can be synced using these steps immediately after a fresh install (either via download or Git clone):

drush config-edit system.site (Update the UUID to match the base site)

If you manually saved the files, upload the base site config profile, but do not sync it
If you cloned the repo, the files should be in place. If the git repo has moved beyond the base install, check out the repo at the ‘Base Site Profile’ stage mentioned above using git reset --hard $SHA1 (where $SHA1 is the SHA of the Base Site Profile)

drush config-import --partial

Important Note: Every new instance MUST start with the same base configuration profile, otherwise you may have entity mismatch issues, even with the partial import. After the initial sync is complete, you can pull in config files via Git and sync will work as expected, even over multiple configuration changes.

Creating a Theme

This will be covered in our next post: “Up and Theming with Drupal 8.”


The post was written at the end of 2015 while Drupal 8 was still in a Release Candidate stage. While some effort will be made to keep the post up-to-date, if it’s after 2016, you should probably be adding the year you are currently in to your Google search, or better yet, check the docs on Drupal.org.


When I was very young, I had a dear friend whose name was Frank.

He was a year or two older than me, but we were like brothers. We even did a blood brother ceremony during a sleepover when we were… 7? 8? It’s hard to remember.

Which is to say, we were as close as two friends can be at that age. He was the first person outside my family that I ever loved.

We were friends for about 4 years, until my parent moved to get away from the oppressive nature of suburban law and watchful neighbors. But for a year or so, Frank and I were in the same school. It was Tonquish elementary school on Warren road (now a church). We lived on a street called Blackfoot, in Westland, Michigan. All the houses were the same;  late 1960’s – early 1970’s ranch houses.

School was unremarkable, except for one odd thing. There was a girl who was in and out of school, whose name was… Beth? I don’t recall much about her except that one time when she was in school, someone pulled her hair, and it turned out it was a wig (I think they knew, which is why they pulled on it). She lived just four houses down from me, but I never saw her playing, so we were not friends.

When they pulled off her wig she was nearly bald, and I remember everyone laughing as they moved away from her. For my part, I recall being confused. In my memory, she clutched her books to her chest and looked down, humiliated, as a teacher waded in and broke up the spectacle.

Some time after that, perhaps after school was out for the year, my friend Frank came to me with a grim look on his face.

“You know that girl Beth, who we went to school with?”

I said yes, I remembered her.

“You remember? We laughed when someone pulled off her wig?”

Yes, I said. I remembered that.

“Well,” he said softly, looking down. “Well… my mom said she had… Lu-ke-mia?  And she was sick, which is why she lost her hair. But after school was out she went back to the hospital. And… she died.”

Frank looked at me with a burning stare. “We laughed at her.”

“Yeah.” I said. It was true.  We all laughed at the girl who lost her hair. I felt so ashamed.

Frank stood for a moment full of rage. “We should go tell her mom we’re sorry.”

“Yeah.” I said. “We should. I’ll go with you.” I recall being very scared.

So we walked down the street to the house where we knew she had lived, and Frank rang the bell. A woman answered the door, who looked to be about 30, but also looked like she had not slept in many years. Dark hair, no makeup, and the saddest eyes I have ever seen on a living person.

“Yes?” she said, slightly confused, as she held the screen door open a little.

Frank spoke haltingly – “Ma’am, uh… We just wanted to tell you that we teased your daughter when we were in school, but we didn’t know she was sick, and we’re really sorry.”

The woman burst from the door with a cry and wrapped her arms around Frank. I jumped back in an act of pure self-preservation, presuming that the end was near for both of us.

The woman, Beth’s mother, wept uncontrollably on Frank’s neck. “Oh my darlings,” she sobbed, “It’s OK. You didn’t know. I forgive you. Oh my god, thank you. Thank you, thank you, thank you. It’s all right, you didn’t know. I love you. Thank you for telling me this. Thank you. I forgive you.”

She broke down so hard. I don’t remember a lot of it because it was so emotional. I know we were all crying. She went back into her house eventually, and closed the door.

Frank and I walked out to the sidewalk, shaken, and very quiet.

One of us said, “I’m glad we did that.”  The other nodded. “Yeah.”

Frank looked angry again, and looked at me.

“Let’s make sure,” as he teared up, “that we never, ever make fun of someone like that again. Never Ever.

I was feeling Franks anger myself, just thinking about it.

“Yeah.” I said, “We should never do that to someone.”

“Ok, then. We swear, as blood brothers…” as he held out his hand.

I took it, and said with all the heart a 10 year old human has, “I swear. Never. Never ever.”

~ Joe K

Smoked Pepper Vodka

    Use this file Immature jalapeno capsicum annuum var annuum
CC BY-SA 3.0 – http://commons.wikimedia.org/wiki/User:Taragui

Wash 6 plump, firm, smooth-skinned Jalapenos or other similar peppers, then cut them in half lengthwise. Remove ribs and seeds. You might want to wear rubber gloves for this!

For a gas stove, use metal tongs and cook the Jalapenos skin-side down over a medium flame until well blackened. For an electric stove, set a wire cooling rack over a burner on high and set them skin-side down until well charred.  If your stove hood vents outside, set it to high, otherwise open your windows. A grill also works well.

Immediately after blackening, put them in a covered dish until cool. Rinse under cool water & rub the black skins off.

Slice thinly, put them in a quart mason jar, and cover w. vodka. Age in the fridge for about two weeks, shaking now and then.

After two weeks, decant the Vodka into decorative bottles w. a few pieces of Jalapeno for decoration.

I have generally used Tito’s vodka, but anything in the $15-25 range should be OK.

Welcome to Portland

Crossing the Buckman Bridge
Crossing the Buckman Bridge. It’s windy.

The past few  weeks have been a bit of a blur. My good lady wife Rachel and I decided last year that we should move to Portland (PDX) from Raleigh-Durham (RDU) for several excellent reasons, to wit:

  • The weather in RDU is overbearingly hot and sweaty in the Summer, a period that spans Apr-Oct, roughly.
  • I’ve suffered constant flu-like allergies every year I’ve lived in the state, mostly due to ragweed pollen.
  • We’d like to downsize our lives as much as possible, but that’s not really an option in a city where two cars are more or less mandatory due to sprawl and poor public transportation.
  • My wife would like to start her business in a location that has a good blend of tech and a strong independent art/comics scene.

Portland really seems to fill all of our requirements, and then some – the cost of living in a high-density urban location is about the same as RDU suburbs, with lower costs for food and transportation.

Continue reading Welcome to Portland

2013 in Review

All in all, an excellent year.

  • Did the Run Free marathon in Feb with excellent friends.
  • Finished the house renovations.
  • Really dug in at work and loved it. Did the font-end development for several cool websites, and blogged about it.
  • Went to Berlin with my Good Lady Wife and had a lovely time.
  • Successfully avoided most relatives and their attached drama for the entire year.
  • Ran regularly, getting up to 12 miles in Summer.
  • Managed to keep my weight under control (+/- 5lb).
  • Learned to cook Indian food.
  • Reduced my personal possessions down to what will fit in a storage/moving pod.
  • Spent the week of Christmas in Philly with my lovely wife and some very cool friends.

Best of all, I had my fantastic and brilliant wife (and best friend) Rachel to share it with. :-)

I’m looking forward to many exciting challenges in the New Year, since we’re starting 2014 by selling our house and moving to Portland, OR.

I think I shall write more in the New Year, and perhaps do more cartooning.

See you in Portland!

~Joe K

Enhance Your Profile

A little over a year ago, I switched from PC-based front end development, to Apple/Mac based development. I had been doing Mac and PC desktop support in my previous job, so I was used to OSX, the Mac OS. However, the switch also required me to upgrade the tools I use on a daily basis, including my source code editor and web server platform. It also (finally!) got me working with the Git version-control software on a daily basis, something I had been looking forward to (all the cool kids use Git. Also, no more lost code.).

The best thing (to me) about using Git is that it has me using a Bash shell again, which means I can tweak out my .profile. What’s that you might ask? Why, let me show you!

Continue reading Enhance Your Profile

Wild in Kentucky

Web development is a great field to work in for a lot of reasons, but for me the best reason is the variety. One day you’ll be adding a guest editor to a high-volume cooking website, the next day you’re adjusting the responsive menu on a drug-culture magazine, and the day after that you’ll be tweaking the careers page on a material handling solutions company’s site — it never gets boring.

Continue reading Wild in Kentucky

Front-end Developer Employer Questions

The Front-end Job Interview Questions list (https://github.com/darcyclarke/Front-end-Developer-Interview-Questions) is pretty awesome–if you’re an employer. It gave me the idea to have a list of questions for front-end developers to ask prospective employers.

These questions cover employers who are large enough to have a dedicated development team. It should work reasonably well for both agencies and companies that are working on internal projects.

Interviews usually happen with both Managers and Team Members, so I’ve split the questions into those two general categories.

Continue reading Front-end Developer Employer Questions

Opacity in decimal, then Hex

If you’ve ever set CSS background colors to semi-transparent, you’ve had to make the cross-browser compatible. Here’s the basic code:

  background: rgba(0, 0, 0, 0.8);
  filter: progid:DXImageTransform.Microsoft.BasicImage(rotation=1);
  filter:progid:DXImageTransform.Microsoft.gradient(startColorstr=#cc0E212A, endColorstr=#cc0E212A);
  -ms-filter: "progid:DXImageTransform.Microsoft.gradient(startColorstr=#cc0E212A, endColorstr=#cc0E212A)";

The first line is for all the modern browsers, the next three for MSIE varients (IE7, IE8, etc). Important to note – don’t have a solid color declaration or it will override the filters in IE.

Also, and most annoying, the IE opacity is in HEX, not decimal. (That’s the first two digits of the #cc0E212A string). It’s oddly difficult to find cheat sheets, so here’s one:

10% = 19
20% = 33
30% = 4c
40% = 66
50% = 80
60% = 99
70% = b2
80% = cc
90% = e6

Mostly, this is for my own reference.

Code, Essays, and other thoughts by Joe K~