This document provides instructions for setting up a local Drupal development environment on your desktop using MAMP. It outlines the necessary software, including MAMP, Drupal, drush, and GitHub. It then walks through configuring the virtual host, installing Drupal, enabling drush, and connecting the local site to GitHub for version control. The goal is to have a fast, easy, and safe way to run and debug a Drupal site locally.

1. Drupal on your Desktop

2. Drupal on your Desktop
Running a webserver and database locally

3. Drupal on your Desktop
Running a webserver and database locally
• Fast
• Easy
• Safe
• Eliminates network issues in debugging

4. Things you’ll need

5. Things you’ll need
Several easy packages available

6. Things you’ll need
Several easy packages available
• MAMP (or WAMP) - http://www.mamp.info/
• Drupal
• admin password for your machine

7. Things you may want

8. Things you may want
Recommended

9. Things you may want
Recommended
• drush
• wget
• a good text editor
• GitHub for Mac

10. MAMP

11. Hostname
edit your /etc/hosts:
add
127.0.0.1 mysite.mydomain.local
This will allow your browser to find your local site

12. Drupal
Unpack Drupal into your htdocs
/Applications/MAMP/htdocs

13. Drupal
Create your site directory at
/Applications/MAMP/htdocs/sites/mysite.mydomain.local
Copy sites/default/default.settings.php into
sites/mysite.mydomain.local as settings.php
Create sites/mysite.mydomain.local/files
Set permissions (chmod 777 *)

14. MySQL
Visit phpMyAdmin
Set a root password
Create an empty database and a user/password set with
access to it

15. Virtual Host setup
edit your
/Applications/MAMP/conf/apache/httpd.conf:
1. Check that
NameVirtualHost *:80
is not commented out
2. <VirtualHost *:80>
DocumentRoot "/Applications/MAMP/htdocs"
ServerName d7tester.resonetrics.local
</VirtualHost>

16. Install Drupal
Visit mysite.myserver.local
Go through standard install process

17. Install Drush
Get drush from drupal.org/project/drush
Unpack wherever it’s convenient
Add drush to your $PATH
or make an alias in /usr/bin, /usr/local/bin, etc.

18. Use Drush
Navigate to sites/mysite.myserver.local in your terminal
type “drush” for a list of commands
drush up - updates your modules and runs update.php
drush cc - clears cache
drush dl <project_name> - downloads a module
drush en <project_name> - enables the module for the
current site only

19. Git and GitHub
Go to
github.com and make an account
Generating ssh keys:
https://help.github.com/articles/generating-ssh-keys
http://mac.github.com/