Local Development Environment

It is important to have a local development environment that works for you. Having a reliable development environment will keep you up and running. It is your pen, your hammer, your sword. Some options are available below, feel free to choose the one that works for you. All of them require git command line installed.

KalaBox

1. Install KalaBox
   1. Alternatively, to build from source, download KalaBox:

      1. git clone git@github.com:kalabox/kalabox.git ~/.kalabox

         cd ~/.kalabox

   2. Build KalaBox

      1. # Builds for OSX

         make osx

         # Builds for Windows

         make windows

         # Builds for .deb/.rpm

         make linux

   3. Install KalaBox by double clicking the installer in the `dist` directory
2. Create your development environment

   1. mkdir -p ~/Sites

      cd ~/Sites

      kbox create drupal7 -- --name="MySite"

3. Set up the site
   1. cd ~/Sites/mysite
   2. `kalabox-compose.yml:appserver:port` can become `"8000:80"` to have the site serve at `http://localhost:8000`
   3. Execute `kbox services` to see the database settings
   4. The `code` directory is your application code. Switch this out with your project's code base:

      1. rm -rf code

         git clone git@github.com:kalamuna/MYSITE.git code

4. Import the database from Pantheon
   1. Visit the Pantheon Dashboard
   2. Download a database backup from Pantheon
   3. Import the database to KalaBox

      1. gunzip -c mysql-backup.sql.gz | kbox drush sql-cli --database=database

   4. TODO: Update this to sql-sync

5. Run the site
   

   1. kbox start

6. Load the site up in your browser: http://localhost:8000 or the URL KalaBox provides.

DrupalVM

1. Install Vagrant 
2. Install VirtualBox 4
3. Check out DrupalVM

   1. git clone git@github.com:geerlingguy/drupal-vm.git ~/.drupalvm

      cd ~/.drupalvm

4. Update the configuration
   1. Copy example.drupal.make.yml to drupal.make.yml
   2. Copy example.config.yml to config.yml
   3. Change configuration in config.yml
5. Check out the site source code

   1. mkdir -p ~/Sites
      git clone git@github.com:kalamuna/greenbiz.com.git ~/Sites/mysite

6. Update ~/.drupalvm/config.yml to point local_path to ~/Sites/mysite
7. Run the site

   1. cd ~/.drupalvm

      vagrant up

8. Import the Database from Pantheon
   1. Visit the Pantheon Dashboard
   2. Download a database backup from Pantheon
   3. Import it

      1. gunzip -c mysql-backup.sql.gz | drush @drupalvm.drupalvm.dev sql-cli

   4. TODO: Update this to sql-sync
9. Load the site at http://drupalvm.dev/ if you didn't configure the port in config.yml.