Acquia Drupal Stack - Installation

Stack and site installation overview

  1. Installing the Acquia Drupal Stack and first local website
  2. If installation fails
  3. Launching the stack control panel
  4. Uninstalling the Acquia Drupal stack

1. Installing the Acquia Drupal Stack and first local website

  1. Download the Acquia Drupal Stack installer package for your operating system from http://acquia.com/downloads to your local computer.

    • For Windows, this will be a file called something like acquia-drupal-win-1.x-x.x.exe.
    • For Mac OS X, this will be a disk image file called something like acquia-drupal-osx-1.x-x.x.dmg

  2. Run the installer

    • Windows - Double click the installer .exe file to begin installing the Acquia Drupal Stack.
    • Mac OS X - Double click the .dmg file to mount it. Begin installing the Acquia Drupal Stack by double clicking the Acquia Drupal Stack Installer file contained in the .dmg (Do not drag it into the applications directory). Depending on your security settings, you might need enter your administrative password to permit the installation.

    Stack installer splash panel

  3. Welcome to Acquia Drupal screen - Read the installer's welcome message. Click "Next" to continue.

  4. Select installer components Windows only. The XMailer component allows sites hosted in the Acquia Drupal stack to send e-mail. Mac OS X has this functionality built in.

  5. Overview screen - This page shows the names and versions of the software about to be installed. Click "Next" to continue.

  6. License Agreement screen - Read the license agreement. To accept the term of the license , click the "Yes" radio button. Click "Next" to continue.

  7. Choose Installation Location screen - You can define alternate installation locations for the Acquia Drupal Stack on this screen. The standard locations are appropriate for most users' systems.

    • Windows

      • Acquia Drupal Stack: C:\Program Files\acquia-drupal
      • Site: C:\Documents and Settings\Administrator\Sites\acquia-drupal-site

    • Mac OS X

      • Acquia Drupal Stack: /Applications/acquia-drupal
      • Site: /Users/[username]/Sites/acquia-drupal-site

    Click "Next" to continue.

  8. Port Settings screen - You can define alternate ports to access the Apache web server and MySQL database server on this screen if the standard ports conflict with other applications on your system. Click "Next" to continue.

  9. Drupal Settings screen

    • Username and password - These are the login credentials for Drupal User 1 on your new locally hosted website.

    • E-mail

      - Enter a working e-mail address - if your local site has access to the internet, you will be able to reset your password via this address.

    • Keep this information for future reference - You need it to access and make changes to your website.

    Click "Next" to continue.

  10. Review Your Information screen - Check that all settings are correct and click "Next" to continue.

  11. Ready to Install screen - Click "Next" to install the Acquia Drupal Stack using your settings. The installation takes a few minutes to complete.

    Windows Firewall

    Near the end of the Windows installation, you may see a Windows security alert asking you if you want to keep blocking the Apache HTTP server's connections from the Internet or a network. Click "Unblock" if you want full functionality, including access your Drupal web site from outside your computer. Alternatively, block it if required by your security needs and you do not need to access your web site from outside your computer.

  12. Congratulations, you're done! screen - If the checkbox is checked, you can now launch the Acquia Drupal Control Panel application by clicking "Finish".

2. If installation fails

All registered users of acquia.com are encouraged to participate in the installer support forums.

  • Check the Windows, Mac or Windows Web Platform Installer forums to see if other users are experiencing similar problems to yours.
  • When making a new forum post, include if present, installer.log and piscript.log from your installation directory. These files help in the troubleshooting process.
  • Stack installer support questions may also be sent to installer-support@acquia.com. Be sure to attach the aforementioned log files.

3. Launch the stack control panel

  • Windows - Select the Windows Start > All Programs > Acquia Drupal Stack menu item.
  • Mac OS X - Double click the control panel application: /Applications/Acquia Drupal/AcquiaDrupalControlPanel.app

DAMP stack control panel

4. Install multiple, local Drupal sites

The Acquia Drupal Stack Installer supports multiple sites and has a simple wizard-type functionality for creating them quickly and easily. See the Adding additional local sites section of this documentation.

5. To uninstall the Acquia Drupal Stack

Windows

  • Shut down the Acquia Drupal stack with the "Stop" button. Close the stack control panel application.

  • Select the uninstall option from the start menu at Start > All Programs > Acquia Drupal Stack > Uninstall Acquia Drupal Stack

  • Follow the instructions to uninstall the stack. Uninstallation also removes all of the components installed by the stack installer:

    • Acquia Drupal installation and directories
    • MySQL database
    • DAMP technology stack

Mac OS X

  • Shut down the Acquia Drupal stack with the "Stop" button. Close the stack control panel application.

  • Double click "uninstall.app" in the directory: /Applications/Acquia Drupal

  • Follow the instructions to uninstall the stack. Uninstallation also removes all of the components installed by the stack installer:

    • Acquia Drupal installation and directories
    • MySQL database
    • DAMP technology stack
‹ Acquia Drupal Stack InstallerupAcquia Drupal Stack - FAQ ›