Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

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.

Table of Contents

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.

...

Lando

Visit the official documentation for installation instructions.

DDEV

Visit the official documentation for installation instructions.