Last updated November 14, 2014.

Introduction

Use these instructions to set up a Drupal 8 environment on your own computer, so that you can begin to test and contribute back to the community. This method is primarily designed to reduce the reliance on an external network when used at large events, but also works fine when you are at home by yourself.

Report any issues you have or suggested improvements to documentation at:
https://drupal.org/node/2272145


What is this doing?

The instructions for each OS help you download a package with the various application installers and an automated installation script to do the installing.

On Linux the steps are somewhat more manual, on OS X and Windows the script:

  1. Prompts to install an IRC client
  2. Prompts to install Sublime Text 3 editor
  3. Prompts to install git
  4. Prompts if you want to configure git as per: https://drupal.org/documentation/git/configure
  5. Prompts for git username and email
  6. Extract Drupal 8 core and do a git pull to ensure you have latest commits for core
  7. Runs Acquia Dev Desktop installer


Linux

Install Bittorrent Sync from the supplied USB key, or if no key was provided download Bittorrent sync now (you need version 1.4+), to find your cpu version run the following in a terminal:
uname -m

After downloading, extract the downloaded tar.gz file to the desired location (BitTorrent Sync has permissions to execute by default).

Open terminal and run the following commands from the directory you extracted btsync:

sudo tar -C /usr/local/bin -zxvf [name of downloaded btsync archive]
btsync --dump-sample-config > ~/btsync.conf
mkdir ~/btsync-store
mkdir '~/btsync-store/Drupal Community Tools Linux'
nano ~/btsync.conf

In the conf file, set and remove comments in front (//) for:
  • "storage_path" : "btsync-store/",
  • ,"login" : "%replace_me%"
  • ,"password" : "%replace_me%"

Set login and password to non-default values as the web user will have the ability to create folders and add new sync codes, which may be undesirable. Then save your changes.

Start bit torrent sync using the following command:

sudo btsync --config ~/btsync.conf

At this point, you should be able to point your web browser to port 8888 on your server and you will see the BTSync GUI (http://youripaddress:8888).

Click the "Gear" icon on the right side of the screen, choose "Enter a key or link" and paste the following URL into the form.

https://link.getsync.com/?f=Community%20Tools%20Linux&sz=24E7&s=YIL3XPU5...

Once BitTorrent Sync has finished downloading the folder navigate to it and open 1. Setup Instructions.pdf which has instructions for completing the installation.


Mac OS X

Install Bittorrent Sync from USB key if one was supplied then click the following link, otherwise just click this link to sync the OS X btsync share

Check "I have read and agree to the Privacy Policy and Terms" and click the Next button.

BitTorrent Sync will synchronize chosen folder(s) immediately. You can access BitTorrent Sync's interface via the Menu Bar (Mac) or System Tray (Windows) icon.

Once BitTorrent Sync has finished downloading the folder navigate to it and open 1. Setup Instructions.pdf which has instructions for completing the installation.


Windows

Install Bittorrent Sync from USB key if one was supplied then click the following link, otherwise just click this link to sync the Windows btsync share

Check "I have read and agree to the Privacy Policy and Terms" and click the Next button.

BitTorrent Sync will synchronize chosen folder(s) immediately. You can access BitTorrent Sync's interface via the Menu Bar (Mac) or System Tray (Windows) icon.

Once BitTorrent Sync has finished downloading the folder navigate to it and open 1. Setup Instructions.pdf which has instructions for completing the installation.


Instructions for event organisers

The purpose of this setup method is to reduce external network load:

  • Ideally you have several mentors connected to the network who already have the folders synced to their computers
  • The BTSync installers are provided to attendees on a thumb drive with a PDF of these instructions

If you are unable to provide thumb drives you can direct participants to download Bittorrent Sync directly instead.

Trouble? Check for updates

Ensure you are using btsync version 1.4 or above, and ensure the time is correct on your computer.

These instructions were created by Brian Gilbert (realityloop).

AttachmentSize
Community Tools Download Instructions240.92 KB

Comments

sja45uk’s picture

Is there any reason why the Community Tools Windows folder has not been updated to use the newly released Drupal 8 beta? I see it does a git pull to update core but it might be better to start with the latest baseline.

realityloop’s picture

Hi Steve, the tools will always be including HEAD as they are primarily designed for those wanting to contribute, there is nothing stopping you from installing Drupal using your preferred version though.