DOCUMENTATION Acquia Dev Desktop - Acquia Help Center

DOCUMENTATION Search the library

Documentation

Acquia Cloud

Acquia Cloud SiteFactory

Acquia Dev Desktop 2

Acquia Ready

Acquia Dev Desktop

Acquia Lift

Acquia Platform APIs

Acquia Search

Acquia subscriptions

Drupal Gardens

Drupal distributions

Mollom

Remote Administration

Support Users Guide

What's new in Acquiaproducts

Documentation

Acquia Dev DesktopThe Acquia Drupal stack installerAcquia Dev Desktop is a Drupal-specific xAMP stack installer, or "DAMP stack". It is thefastest way to set up Acquia Drupal to run locally on Windows or a Mac.

NEW VERSION NOW AVAILABLE

Download the next major release of Acquia Dev Desktop to take advantage of major improvements,including greatly enhanced integration with Acquia Cloud. It's available for Mac and Windows. Learn more.

In just a few clicks, you have a full Acquia Drupal website up-and-running on your computer. With a few clicksmore, you can install more. You can use these sites to evaluate Acquia Drupal, add and test other Drupalcomponents, workflows and functionality - and even get things wrong without worrying about ruining a live,production website.

What if you've already installed part of the xAMP stack? Acquia Dev Desktop installs separate copies of thexAMP stack onto your computer, both to ensure that you have the versions of the software required for Drupal,and to not affect the settings of the applications you've already installed on your computer.

ComponentsAcquia Dev Desktop's xAMP stack consists of the following components:

Component Description

AcquiaDrupal

A packaged distribution of the open source Drupal social publishing system.

ApacheHTTPServer™

The world's most popular web server.

MySQL™

DatabaseServer

The world's most popular database server.

PHP The language that powers Drupal. (To view a full listing of the PHP extensions and variablesafter you install Acquia Dev Desktop on your computer, see the Config tab roll-up informationat Control Panel settings.)

phpMyAdmin A popular in-browser database management tool.

Acquia DevDesktopControlPanel

The control panel shows the status of the Dev Desktop's Apache and MySQL servers, allowsyou to start and stop them, and gives you access to your local Acquia Drupal website,phpMyAdmin and the settings window of the control panel itself.

XMail Server(Windows

Allows your locally installed site to send e-mail directly. This is important for password reset,testing, and other functionality. (Mac OS X includes this built-in functionality.)

https://docs.acquia.com/documentation

https://docs.acquia.com/cloud

https://docs.acquia.com/site-factory

https://docs.acquia.com/dev-desktop2

https://docs.acquia.com/acquia-ready

https://docs.acquia.com/node/21

https://docs.acquia.com/lift

https://docs.acquia.com/api

https://docs.acquia.com/acquia-search

https://docs.acquia.com/network

https://docs.acquia.com/drupal-gardens

https://docs.acquia.com/distro

https://docs.acquia.com/mollom

https://docs.acquia.com/ra

https://docs.acquia.com/support/guide

https://docs.acquia.com/release-notes


https://www.acquia.com/products-services/dev-desktop

https://www.acquia.com/downloads


https://www.acquia.com/products-services/acquia-drupal

https://docs.acquia.com/dev-desktop/control/settings

Developing on Acquia Cloud Acquia Lift

only)

Getting started with Acquia Dev DesktopYou can install Acquia Dev Desktop onto several different supported operating systems.

Use the procedures in this guide to install Acquia Dev Desktop onto your computer, or to upgrade your DevDesktop installation.

Need technical support for Acquia Dev Desktop? See the Acquia Dev Desktop FAQ for details.

For additional information, browse the Knowledge Base articles in the Acquia Help Center.

WAS THIS HELPFUL?

https://docs.acquia.com/acquia-ready/developing-acquia-cloud


https://docs.acquia.com/dev-desktop/supported

https://docs.acquia.com/dev-desktop/install

https://docs.acquia.com/dev-desktop/upgrade

https://docs.acquia.com/search/site?f%5B0%5D=bundle_name%3AKB%20Article


Documentation

Supported operatingsystems

Acquia Cloud



Acquia Ready

Acquia Dev Desktop

Acquia Lift


Acquia Search


Drupal Gardens


Mollom


Support Users Guide


Documentation

Supported operating systems

Documentation Acquia Cloud

Acquia Dev Desktop has been tested with the following operating systems:

Mac® OS X 10.8 Mountain Lion® (Intel® only)

OS X 10.7 Lion® (Intel® only)

OS X 10.6 Snow Leopard® (Intel only)

OS X 10.5 Leopard® (Intel only)

Windows® Windows 7 (32-bit and 64-bit)

Windows Server® 2003 (32-bit and 64-bit)

Windows Vista® (32-bit and 64-bit)

Windows XP (32-bit and 64-bit)

Mac OS X 10.9 Mavericks is not supported. Use Acquia Dev Desktop 2 instead. Learn more about Acquia DevDesktop 2.

Technical supportNeed technical support for Acquia Dev Desktop? See the Acquia Dev Desktop FAQ for details.

WAS THIS HELPFUL?























https://docs.acquia.com/dev-desktop/faq


Documentation

Installing Acquia DevDesktop

Acquia Cloud



Acquia Ready

Acquia Dev Desktop

Acquia Lift


Acquia Search


Drupal Gardens


Mollom


Support Users Guide


Documentation

Installing Acquia Dev DesktopTo install Acquia Dev Desktop and an initial default website, complete the following steps:

1. Download Acquia Dev Desktop from the Acquia Downloads page. There are four downloads to choose from,including Acquia Drupal 6 and Acquia Drupal 7 versions for each of Windows and Mac OS. The AcquiaDrupal 6 and Acquia Drupal 7 versions are identical except for the version of Drupal that is included in thedownload. You can use either version to import an existing Drupal 6 or Drupal 7 website.

NOTE

Mac OS X 10.9 Mavericks is not supported. Use Acquia Dev Desktop 2 instead. Learn more aboutAcquia Dev Desktop 2.

2. Start the installation process. To do this, use the method based on your operating system:

3. Inspect each installation window, and after you provide any requested information, click Next.

4. Windows-only: If you want your site to be able to send email, select XMail server on the Selectcomponents page, and then click Next. The XMail server is a full-featured email server, and it allows siteshosted in Dev Desktop to send email.

5. On the Choose install locations page, select the directory in which to install Dev Desktop, as well as thedirectory for the files associated with your websites, and then click Next.

6. On the Port settings page, you can define alternate ports to access the Apache web server and MySQLdatabase server if the standard ports conflict with other applications on your web server. After you verify theport values, click Next.

7. On the Drupal settings page, enter the following information:

Site name

The name of your initial website.

Username and Password

Keep a record of these login credentials. They will be the login credentials you need to log in as user 1 onyour new locally-hosted website.

E-mail

A working email address. If your local site has access to the internet, you can reset your account

Windows

Navigate to the folder where you downloaded the file, and then run the Dev Desktop installation file.

Mac

Double-click the installation .dmg file to mount it, and then right-click the Acquia Dev Desktop StackInstaller icon and select Open. Depending on your security settings and OS version, you might need to enteryour administrative password to continue with the product installation.

Note: Do not drag the Acquia Dev Desktop Stack Installer into the Applications directory.



















http://www.acquia.com/downloads



https://docs.acquia.com/node/15651#


Documentation Acquia Cloud

password using this email account.

8. Click Next.

9. Complete the installation. Note that the installation process can take several minutes to complete.

Windows-only Note: Near the end of the Dev Desktop installation process, Windows might displayWindows security alerts regarding components of Dev Desktop. If you want to access websites created onthis computer from the Internet or your network, allow access and unblock the Windows Firewall.Alternatively, you can allow the Windows Firewall to continue to block the application if required by yoursecurity needs, or you do not need to access your website from outside of your computer.

After the installation completes, you can start the Acquia Dev Desktop by selecting the "Launch" checkbox,and then clicking Finish.

If you encounter problems during the installation process, see the Acquia Dev Desktop FAQ for troubleshootinginformation.

Note: The Acquia Dev Desktop supports multiple Drupal sites on your local computer. For more information,see Adding additional local sites.

Starting the Dev Desktop Control PanelThe Acquia Dev Desktop Control Panel enables you to stop and start the xAMP services, as well as create andconfigure websites.

To start the Control Panel, use the procedure for your operating system:

Windows: From the Start menu, select All Programs > Acquia Dev Desktop > Control panel.

Mac: Double-click the Control Panel application /Applications/AcquiaDrupal/AcquiaDrupalControlPanel.app.

For more information about the Acquia Dev Desktop Control Panel, see Control Panel.

WAS THIS HELPFUL?




https://docs.acquia.com/dev-desktop/new-site

https://docs.acquia.com/dev-desktop/control


Documentation


Upgrading Acquia DevDesktop

Acquia Cloud



Acquia Ready

Acquia Dev Desktop

Acquia Lift


Acquia Search


Drupal Gardens


Mollom


Support Users Guide


Documentation

Upgrading Acquia Dev DesktopWhen you upgrade Acquia Dev Desktop, the installed version of Drupal and all of its required components(Apache, MySQL, and PHP) are updated to newer versions. The upgrade process also preserves all sitedatabases and configuration data (including paths and ports numbers).

You cannot use the Acquia Dev Desktop upgrade process to do the following:

Update installed modules.

Change or update other local sites you have imported into or built in the Acquia Dev Desktop that run otherversions or distributions of Drupal or their modules (Drupal 5, 6 or 7 from drupal.org, Pressflow, OpenAtrium, etc.).

You don't have to upgrade your installed version of Acquia Dev Desktop if a new version of Drupal is released.While you cannot use the new Drupal version to create the default site, you can create additional sites based onan unbundled Drupal distribution.

Note: Acquia Drupal can include released, beta, alpha, or patched modules depending on which version isdetermined to be the most current, stable, secure and appropriate version for general use.

If you update a production site, you should always perform a backup first, and, if possible, perform a trialupdate in a test environment before updating their production site.

For some of the modules being upgraded, it is important to make sure that the new version of the modulecompletely replaces the old one (i.e., that the entire module's directory is replaced and that there aren't anyfiles from the old version that remain). Please follow the recommended upgrade procedures found in theGetting Started guide.

If you experience problems during the upgrade, clearing Drupal's caches may be necessary. You can do thisby going to Administer > Site configuration > Performance (?q=admin/settings/performance), andclicking the Clear cached data button at the bottom of the page. You may be prompted to run your site'sdatabase updates more than once, and if you see error messages during the upgrade they do notnecessarily indicate a problem.

To upgrade Acquia Dev Desktop, complete the following steps:

1. Back up the following items to a separate directory:

Drupal root directory

The /sites root directory (This directory contains your configuration file, added modules and themes,and your site's uploaded files.)

2. Download an updated version of Acquia Dev Desktop from the Acquia Downloads page.

3. On the Acquia Dev Desktop control panel, click Stop, and then close the Dev Desktop control panel.

4. Start the upgrade process. To do this, use the method based on your operating system:

5. Inspect each installation window, and after you provide any requested information, click Next.

6. On the Choose install locations page, ensure that the fields contain the directory where Dev Desktop isinstalled, as well as the directory for the files associated with your websites, and then click Next.

Windows

Mac




















https://docs.acquia.com/dev-desktop/import-site

https://docs.acquia.com/acquia-drupal





Acquia Cloud

After the installation completes, you can start the Acquia Dev Desktop by selecting the "Launch" checkbox,and then clicking Finish.

If you encounter problems during the upgrade process, see the Acquia Dev Desktop FAQ for troubleshootinginformation.

Note: If the upgrade process encounters problems during the upgrade, or if you have modified any code inAcquia Drupal or its modules, the upgrade process creates backups of your code before overwriting old codewith new code in the following scenarios:

When you upgrade from Acquia Dev Desktop version 1.2.24 or earlier (Drupal 6), any site created using thecontrol panel site-creation functionality is backed up into the [docroot]/#oldsite directory, and thenfiles in the existing installation directory are overwritten with the new files.

When you use Acquia Dev Desktop version 1.2.25 and later (Drupal 6), Dev Desktop creates a .hashlistfile in the site docroot. This makes it possible to detect which files, if any, have been modified. During anupgrade, all unmodified files are overwritten, while modified files are copied to corresponding[filename].bak files in the same directory, and then replaced with the upgraded version of the file. Theinstaller copies all overwritten files to the acquia-drupal/rollbackBackupDirectory directory.

Starting the Dev Desktop Control PanelThe Acquia Dev Desktop Control Panel enables you to stop and start the xAMP services, as well as create andconfigure websites.

To start the Control Panel, use the procedure for your operating system:

Windows: From the Start menu, select All Programs > Acquia Dev Desktop > Control panel.

Mac: Double-click the Control Panel application /Applications/AcquiaDrupal/AcquiaDrupalControlPanel.app.

For more information about the Acquia Dev Desktop Control Panel, see Control Panel.

WAS THIS HELPFUL?




https://docs.acquia.com/dev-desktop/control


Documentation



Uninstalling Acquia DevDesktop

Acquia Cloud



Acquia Ready

Acquia Dev Desktop

Acquia Lift


Acquia Search


Drupal Gardens


Mollom


Support Users Guide


Documentation

Uninstalling Acquia Dev Desktop


Acquia Cloud

Note: Before you uninstall Acquia Dev Desktop be sure to back up your websites' files and databases usingSettings > Sites > Export. Uninstalling Acquia Dev Desktop deletes the websites contained by Acquia DevDesktop, including your websites' files and databases.

To uninstall Acquia Dev Desktop, complete the following steps:

1. On the Acquia Dev Desktop Control Panel, click Stop, and then close the Acquia Dev Desktop control panel.

2. Run the uninstallation application. To do this, use the method based on your operating system:

Windows: From the Start menu, select All Programs > Acquia Dev Desktop > Uninstall Acquia DevDesktop.

Mac: Double-click /Applications/Acquia Drupal/uninstall.app.

3. Follow the instructions to uninstall Acquia Dev Desktop. The uninstallation process removes the followingcomponents installed by Acquia Dev Desktop:

Acquia Drupal installation and directoriesMySQL databasexAMP technology stackWindows-only: XMail server (if installed as part of Acquia Dev Desktop)

If you encounter problems during the uninstallation process, see the Acquia Dev Desktop FAQ fortroubleshooting information.

WAS THIS HELPFUL?

























Documentation




Control Panel

Acquia Cloud



Acquia Ready

Acquia Dev Desktop

Acquia Lift


Acquia Search


Drupal Gardens


Mollom


Support Users Guide


Documentation

Control PanelThe Acquia Dev Desktop Control Panel is the control center for the Acquia Drupal sites installed on yourcomputer that are managed by Acquia Dev Desktop.

Option Description

1 Stop/Start Stops and starts Dev Desktop's Apache and MySQL servers (server restarts arerequired following certain types configuration changes). Services are running ifthey have a green light to their right on the Control Panel.

2 Go to my site Opens the selected Acquia Drupal site in your web browser. To administer yoursite, log in using the username and password of the Drupal account you setduring the installation of Acquia Dev Desktop.

3 Drop-down selector localhost is the name of the first installed site. After you create additionalsites, you can select them from this list.

More opens the Sites tab in the Settings window, where you can add, editand delete local Acquia Drupal sites.

4 Manage my database Opens phpMyAdmin in your web browser.

PhpMyAdmin is a database administration tool that allows you to inspect,browse, create, back up, or restore MySQL databases.

Note: Acquia Dev Desktop creates and deletes databases as a part of the overalllocal site installation and deletion processes.

5 Settings Opens the Settings window, which contains the Acquia Dev Desktopconfiguration tabs. Use the Settings window to configure the Control Panel's

























Acquia Cloud

configuration tabs. Use the Settings window to configure the Control Panel'sbehavior, manage port and configuration settings, view server logs, and managemultiple local Acquia Drupal web sites. For more information about the Settingswindow, see Control Panel settings.

Additional informationNeed technical support for Dev Desktop? See the Acquia Dev Desktop FAQ for details.

For information about adding an additional site to your local Dev Desktop collection, see Adding additional localsites. For information about adding a copy of an existing Drupal installation to your local Dev Desktopcollection, see Importing existing sites and Drupal codebases.

To view additional documentation for Acquia Dev Desktop, including installed components, frequently askedquestions, and troubleshooting, see Acquia Dev Desktop.

WAS THIS HELPFUL?







https://docs.acquia.com/dev-desktop


Documentation

Acquia Cloud



Acquia Ready

Acquia Dev Desktop

Acquia Lift


Acquia Search


Control Panel settings

Drupal Gardens


Mollom


Support Users Guide


Documentation

Control Panel settingsTo access the settings of the Acquia Drupal Control Panel application, click Settings in the main Control Panelwindow.

The Settings window opens with the following tabs:

Startup tab

Option Description

Start stack whenstarting Acquia DevDesktop ControlPanel

Starts the xAMP stack when you open the Acquia Dev Desktop Control Panel if itis not running at that time.

Stop stack whenquitting Acquia DevDesktop ControlPanel

Stops the xAMP stack when you close the Acquia Dev Desktop Control Panel if itis not running at that time.

Open my site atstartup

Starts your web browser and opens the site you select on the Control Panelwindow when you open the Acquia Dev Desktop Control Panel.

Note: If you configure Acquia Dev Desktop to stop the stack when you close theControl Panel and you enable this option, you'll see an error message in your webbrowser stating that the site cannot be loaded the next time you start the ControlPanel.

Ports tab

Acquia Dev Desktop doesn't apply your changes to the values in the port fields until you click OK.

Option Description

Apache port Sets the Apache HTTP Server port for Acquia Dev Desktop. The default value forthis port is 8082.

MySQL port Sets the MySQL port for Acquia Dev Desktop. The default value for this port is33066.

Note: You cannot use port numbers less than 1024 on Mac OS X.

Revert to defaultsbutton

Resets the port values for Apache and MySQL back to their default values.

Config tab

Option Description






















Preferred/DefaultPHP version

Displayed by versions 6 - 1.2.41 or greater and 7 - 7.12.11 or greater.

Select the version of PHP for use with all of your local Acquia Dev Desktop sites.

Note: If you select a different version of PHP, Acquia Dev Desktop does not makethe change until you click OK.

PHP mode Displayed by versions 6 - 1.2.43 or greater and 7 - 7.12.12 or greater.

Sets the PHP module used by Acquia Dev Desktop sites.

Apache module (mod_php) - A single PHP version can set for all sites.

Fast CGI (mod_fcgid) - Sites can have different PHP versions.

Note: If you select a different PHP mode, Acquia Dev Desktop does not make thechange until you click OK.

Apache Sets the location of the Apache configuration file, which includes informationincluding the server root directory, ports, and the server administrator emailaddress.

To manually edit this file, click the Edit link to the right of this field.

Note: You must stop and restart the Acquia Dev Desktop stack to accept anychanges to the configuration file or this field.

MySQL Sets the location of the MySQL configuration file, which includes informationincluding the default user name, port, and directory locations on your system.

To manually edit this file, click the Edit link to the right of this field.

Note: You must stop and restart the Acquia Dev Desktop stack to accept anychanges to the configuration file or this field.

PHP Sets the location of the PHP configuration file.

There are usually no reasons to change this file, and this option is provided for theuse of advanced users.

Note: You must stop and restart the Acquia Dev Desktop stack to accept anychanges to the configuration file or this field. If you must modify this file, click theEdit link to the right of this field.

phpinfo link Displayed by versions 6 - 1.2.43 or greater and 7 - 7.12.12 or greater as links foreach PHP version.

Starts your web browser and opens a site in your browser that providesinformation about the installed version of PHP, including its exact configurationand extensions.

Logs tab

Option Description

Drupal logs link Opens a web browser window and displays the Drupal error and event logs on thiscomputer.

Sites Allows you to select which site for which you want to view the Drupal error andevent logs.

Apache access Displays the location of the Apache access logs.


Site grouping Drupal Gardens

Additional informationNeed technical support for Acquia Dev Desktop? See the Acquia Dev Desktop FAQ for details.

To view additional documentation for Acquia Dev Desktop, including installed components, frequently askedquestions, and troubleshooting, see Acquia Dev Desktop.

Apache access Displays the location of the Apache access logs.

To view the contents of this file, click the View link to the right of this field.

Apache errors Dispalys the location of the Apache error logs.


MySQL errors Displays the location of the MySQL error logs.


Sites tab

Option Description

Website list Lists the website hosted by Acquia Dev Desktop, including their URLs anddatabases.

Note: Versions 6 - 1.2.43 or greater and 7 - 7.12.12 or greater also display thesite's PHP version.

New button Creates a new Acquia Drupal website with a unique local URL and database. Formore information, see Adding additional local sites.

Import button Imports any Drupal 5, 6 or 7 website or codebase. You can choose to import anexisting database or let Acquia Dev Desktop create a new one for you. For moreinformation, see the Importing existing sites Help page.

Export button Exports the selected site to a compressed file or directly to the Acquia Cloud.

For more information about exporting a website directly to Acquia Cloud, seeExporting your website to Acquia Cloud.

For more information about creating a site archive file for your website, seeCreating a Drupal site archive for import.

Go To button Opens the selected site in your web browser.

Edit button Changes the selected site's database and path settings.

Note: Versions 6 - 1.2.43 or greater and 7 - 7.12.12 or greater also allow you tochange the site's PHP version.

Delete button Deletes the selected site, including all files, settings, and database.

WAS THIS HELPFUL?

https://docs.acquia.com/network/manage/group



https://docs.acquia.com/dev-desktop


https://docs.acquia.com/dev-desktop/site/add

https://docs.acquia.com/dev-desktop/site/import

http://www.acquia.com/products-services/acquia-dev-cloud

https://docs.acquia.com/cloud/site/import/dev-desktop/export

https://docs.acquia.com/cloud/site/import/archive/create


Documentation

Acquia Cloud



Acquia Ready

Installing from thecommand line on MacOS

Acquia Dev Desktop

Acquia Lift


Acquia Search


Drupal Gardens


Mollom


Support Users Guide


Documentation

Installing from the command line on Mac OSThe primary way to install Acquia Dev Desktop is to use the GUI installer, as described in Installing Acquia DevDesktop. As an alternative, you can instead install Acquia Dev Desktop and an initial default website from acommand line on Mac OS. To use the command line installer on Mac OS:

1. Download Acquia Dev Desktop from the Acquia Downloads page.

2. Mount the installation .dmg with a command like: hdiutil attach /path/to/acquia devdesktop.dmg

3. Change directories to the Acquia Dev Desktop installer:

$ cd /Volumes/"Acquia Dev Desktop Installer"

$ cd "Acquia Dev Desktop Stack Installer.app"/Contents/MacOS

4. Run the installer:

$ ./installbuilder.sh --<optional arguments>

The installbuilder.sh script takes the following arguments:

Argument Description Allowed and default values

--mode <mode> Installation mode osx (default) — use the Mac OS GUItext — use text prompts on the command lineunattended — use mode specified with the --unattendedmodeui argument, with input from a text filespecified with the --optionfile argument

--

unattendedmodeui

<mode>

UI to use in unattendedinstallation mode

none (default)minimal

minimalWithDialogs

--optionfile

<optionfile>

The path to a text file thatincludes installationoptions.

--admUsername

<admin username>

Username for the adminaccount

--admPass <admin

password>

Password for the adminaccount

--admEmail

<admin email>

Email address for theadmin account

--debuglevel

<debuglevel>

Debug information levelof verbosity

0 1 2 (default) 3 4

--debugtrace

<debugtrace>

The path of a file that theinstaller should writedebug information to.

--installer-

language

Language to run installerin

en (default) ar bg ca da nl et fr fide el es es_AR he hr hu it ja ko pl



















https://docs.acquia.com/dev-desktop/install


Developing on Acquia Cloud Acquia Dev Desktop

<language code> pt_BR pt ro ru no sl sk sq sv tr

zh_TW zh_CN va cy cs

--licenseagree

<licenseagree>

Indicates agreement tothe license

1 (default)

--installDir

<installDir>

The directory to installDev Desktop in

/Applications/acquia-drupal

--siteDir

<siteDir>

The site directory /Users/<username>/Sites/acquia-drupal

--apachePort

<apachePort>

Apache web server portnumber

8082

--mysqlPort

<mysqlPort>

MySQL database portnumber

33066

--siteName

<siteName>

Site name My Acquia Drupal Site

--help Display the list of validarguments for theinstallbuilder.sh script

--version Display productinformation for AcquiaDev Desktop

WAS THIS HELPFUL?




Documentation

Acquia Cloud



Acquia Ready

Acquia Dev Desktop

Find your Acquia DevDesktop version

Acquia Lift


Acquia Search


Drupal Gardens


Mollom


Support Users Guide


Documentation » Acquia Dev Desktop

Find your Acquia Dev Desktop version

Acquia Dev Desktop Acquia Lift

To find your Acquia Dev Desktop version, open the Acquia Dev Desktop Control Panel. The version number is inthe bottom left corner.

WAS THIS HELPFUL?























Documentation

Acquia Cloud



Acquia Ready

Acquia Dev Desktop

Managing your sites

Acquia Lift


Acquia Search


Drupal Gardens


Mollom


Support Users Guide



Managing your sites


Acquia Dev Desktop provides several methods to create and manage your local Drupal sites:

Add additional local sites

Create new, "empty" Drupal websites based on the bundled version of Acquia Drupal.

Import existing sites and Drupal codebases

Import an existing site, or create a new site based on a different Drupal distribution.

Delete sites

Delete a previously created site (including its data) from Acquia Dev Desktop.

WAS THIS HELPFUL?






















https://docs.acquia.com/dev-desktop/site/add


https://docs.acquia.com/dev-desktop/site/delete


Documentation

Acquia Cloud



Acquia Ready

Adding additional localsites

Acquia Dev Desktop

Acquia Lift


Acquia Search


Drupal Gardens


Mollom


Support Users Guide


Documentation

Adding additional local sitesDuring the Acquia Dev Desktop installation process, the installation application creates a default Acquia Drupalsite on your computer. You're not limited to this one site, however. You can install additional sites based on anyDrupal distribution into Acquia Dev Desktop.

Note: Use the information on this page to add a new, empty Acquia Drupal site to your computer that's basedon the version of Acquia Drupal bundled with the Acquia Dev Desktop installation package. If you want tocreate a site based on a version of Drupal not bundled with your installed version of Acquia Dev Desktop, or ifyou have a copy of an existing Drupal site that you want to import into Acquia Dev Desktop, see Importingexisting sites and Drupal codebases.

Creating a siteTo create a new site in Acquia Dev Desktop, complete the following steps:

1. Open the Acquia Dev Desktop Control Panel, and then click Settings. The Settings window opens.

2. Select the Sites tab, and then click New. The New site window opens.

3. Select from the following site creation methods to complete the site creation process:

Quick site creation - Site name field only

To create a new site using the quick site creation method, complete the following steps:

a. Enter the new site's name in the Site name field.

The Site name must begin with a letter or number, and can contain letters, numbers, spaces, hyphens ( -), underscores ( _ ), and apostrophes ( ' ).

As you enter the name of the site, Dev Desktop fills in the Database name, Subdomain, and Site URLfields based on the name of your site. Dev Desktop uses the Username and Password you enteredduring the initial installation of Dev Desktop and first local Acquia Drupal site (User ID 1).





















b. Click OK to create the site.

Custom site creation - multiple required fields

To create a new site using the custom site creation method, complete the following steps:

a. Select the I want custom site details and account settings checkbox.

b. Enter values that describe your new site in the following fields:

Note: The site creation fields on this window must all begin with a letter or number, and can containletters, numbers, hyphens ( - ), and underscores ( _ ).

Site nameThe name of the site in the Acquia Dev Desktop interface. In addition to the characters allowed forfields on this window, this field also accepts spaces and apostrophes ( ' ).

Database nameThe name of the database.

ServerThe server name of the site.

SubdomainThe subdomain of the site.

URL pathThe path to your site.


After Acquia Dev Desktop completes the site creation process, it displays your new site on the Sites tab.

Viewing your new siteUse either of the following methods to view your new site:

The Sites tab on the Settings window displays all of the sites configured in Acquia Dev Desktop. To view asite in your web browser, select a site in the list, and then click Go To.

Note: As you enter the Server, Subdomain, and URL path, Acquia Dev Desktop creates the SiteURL based on these values in the following manner:

http://[subdomain].[server]:[Apache port]/[URL path]

Username and PasswordThe log in credentials for the new site's User 1 account.

EmailA working email address.

c. Click OK to create the site.

The main Control Panel contains a drop-down menu that lists all of the sites configured in Acquia DevDesktop.

To view a site in your web browser, select a site in the list, and then click Go to my site.


Editing site settingsTo modify your site's settings in Acquia Dev Desktop:

1. Open the Acquia Dev Desktop Control Panel, and then click Settings. The Settings window opens.

2. Select the Sites tab, select your site, and click Edit.... The Edit site window opens. You can change a site'sserver name, subdomain, and URL path, but not the site path, which you select when you install Acquia DevDesktop.

3. Click OK.

Technical supportNeed technical support for Dev Desktop? See the Acquia Dev Desktop FAQ for details.

WAS THIS HELPFUL?





Documentation

Acquia Cloud



Acquia Ready

Importing existing sitesand Drupal codebases

Acquia Dev Desktop

Acquia Lift


Acquia Search


Drupal Gardens


Mollom


Support Users Guide


Documentation

Importing existing sites and Drupal codebasesAcquia Dev Desktop can run websites that use Drupal versions 5 and later. With it, you can:

Run copies of existing sites

Import copies of existing Drupal websites (versions 5 and later) into your local Dev Desktop environment fortesting and development. You can use either the Drupal 6 or Drupal 7 version of Acquia Dev Desktop toimport an Drupal website, regardless of the version of Drupal you are importing.

Create new sites using Drupal distributions

Run any Drupal-based installation versions 5 and later in Acquia Dev Desktop for testing and developmentpurposes, including patch testing and core development. Drupal distributions can include updated versionsof Acquia Drupal, downloads from drupal.org, or patched or customized distributions.

If you're going to run a copy of an existing site, you can either import its existing database or have Acquia DevDesktop create a fresh MySQL database for the site.

NOTES

If you want to develop or test a new, "empty" installation of Acquia Drupal, see Adding additional localsites.

If you want to test or work on an existing, modified Acquia Drupal codebase, proceed with theprocedures on this page.

Importing an existing site or codebase into Acquia DevDesktopTo run an existing site or new Drupal distribution on your local computer, complete the following steps:

1. Ensure that your local computer contains a copy of your site's Drupal files and directories (codebase).

Save your site's codebase in a place where you can find it and where you won't delete or move itunintentionally. This protects your site from accidental removal, and helps when you need to modify sitecontent or change the installed modules.

You cannot import zipped or compressed codebases into Dev Desktop. Ensure that your site's code isuncompressed.

For more information about backing up the Drupal file system, see Drupal file system backup.

NOTE

Dev Desktop does not move or copy your site's code into the Dev Desktop installation directory.Instead, Dev Desktop records where the Drupal directories are stored on your local computer.

2. Open the Acquia Dev Desktop Control Panel, click Settings, and then select the Sites tab.




















https://docs.acquia.com/acquia-drupal/appendix/back-up/files

3. Click Import. The Import site window opens.

4. In the Codebase section, click Browse to select the source code directory (also known as [docroot]) ofyour Drupal installation. This directory contains Drupal's files and directories, including index.php, the/includes directory, and the /modules directory.

5. After you select the your codebase, in the Subsite drop-down menu, select the site to import from thesource code directory. For single-site codebases or Drupal distributions, select default. If you're importinga codebase that contains multiple subsites, select the subsite you want to import from the Subsites drop-down menu.

NOTE

Dev Desktop can only import one site at a time.

6. Configure the database settings for the site import process. The settings are based on the type of site orcodebase you're importing into Dev Desktop.

7. In the Database name field, enter a name for the database. If you're restoring a backed up database, thename does not have to match the backed up database's previous name.

8. Under Domain, enter the elements (server, subdomain, and URL path) of the local URL you want to use foryour site. For example, if you want to reach your site locally at http://my.example:8082/mysite, entermy for the Subdomain, example for the Server, and mysite for the URL path. The subdomain and URLpath are optional.

9. Click Import.

Acquia Dev Desktop records the location of your site's Drupal codebase, creates its new database (ifselected), and adds the site to the list of sites in the Sites tab.

Site with an available database backup

In the Database section, select the I have a MySQL database dump file for my site option, and then clickBrowse. Select the database dump file for your site.

Databases must be uncompressed (database_backup.sql), and not gzipped (database_backup.sql.gz).

For more information about backing up Drupal databases, see the Drupal Database Backup appendix of theAcquia Getting Started Guide.

Drupal distribution (Acquia Drupal or download from drupal.org), or no available database backup

In the Database section, select the Create new database option.


https://docs.acquia.com/acquia-drupal/appendix/back-up/database




WAS THIS HELPFUL?





Documentation

Acquia Cloud



Acquia Ready

Acquia Dev Desktop

Acquia Lift


Acquia Search


Backing up sites

Drupal Gardens


Mollom


Support Users Guide


Documentation

Backing up sites

Site grouping Drupal Gardens

Although you can manually back up your website's files and databases, Acquia Dev Desktop provides a simplermethod to create a backup file of your entire website, including its files and databases.

To back up your Acquia Dev Desktop site:

1. Open the Acquia Dev Desktop Control Panel.

2. Click Settings.

3. Select the Sites tab.

4. Select the site that you want to back up from the site list, and then click Export.

5. Select to file from the drop-down menu.

6. Modify the file name and location and then click Save. Be sure to keep the .tar.gz extension at the end ofthe file name.

If you need to restore a backed up website into Acquia Dev Desktop, use the export file that you created withthe procedure in Importing existing sites and Drupal codebases.

WAS THIS HELPFUL?



















https://docs.acquia.com/network/manage/group


https://docs.acquia.com/acquia-drupal/appendix/back-up/files

https://docs.acquia.com/acquia-drupal/appendix/back-up/database



Documentation

Acquia Cloud



Acquia Ready

Acquia Dev Desktop

Acquia Lift


Acquia Search


Drupal Gardens


Deleting sites

Mollom


Support Users Guide


Documentation

Deleting sites

Best practices for addingnew features

Mollom

To delete a site, open the Sites tab in the Settings window, select a site in the list, and then click Delete. Aconfirmation window opens. Click Yes to permanently delete the site, including its MySQL database and allassociated files.

Note: You cannot delete the site created by the Acquia Dev Desktop installation process (the first site in the listof sites on the Sites tab, in the Settings window). To remove this site, you must uninstall and then reinstallAcquia Dev Desktop, which creates a new default site.


WAS THIS HELPFUL?



















https://docs.acquia.com/site-factory/feature/add




Documentation

Acquia Cloud



Acquia Ready

Acquia Dev Desktop

Adding PHP extensionsto Acquia Dev Desktop

Acquia Lift


Acquia Search


Drupal Gardens


Mollom


Support Users Guide



Adding PHP extensions to Acquia Dev DesktopAcquia Dev Desktop for Mac includes phpize to allow users to build PHP extensions that match the version ofPHP it runs.

Note: Acquia Dev Desktop for Windows does not include this function.

RequirementsThis process relies on utilities contained in Apple's Xcode tools. You can obtain these tools from your OS Xinstallation disk, or from http://developer.apple.com/tools/xcode/. Be sure to install Developer Tools Essentialsand UNIX Development Support (also called UNIX Dev Support on some versions) on your computer beforecontinuing with this process.

Installing PHP extensionsYou can build and add any compatible extension from the PECL repository. The following example describeshow to add support for LZF compression using the corresponding PECL extension.

Note: Some extensions have dependencies on other extensions and libraries. Check the project page andinstructions of the extension you wish to install, and be sure to include all dependencies as required.

1. Download the PHP extension tarball, and navigate to its project page.

For this example, the tarball is at http://pecl.php.net/package/lzf. Copy the link of the version of the archiveyou require, and then download it to your computer:

$ curl -O http://pecl.php.net/get/LZF-1.5.2.tgz

2. Untar the PHP extension archive. To do this, use the following command:

$ tar -zxvf LZF-1.5.2.tgz

3. Build the PHP extension. Navigate to the extension directory, and run the following commands.

Note: This command example assumes you have installed Acquia Dev Desktop in its default location(/Applications/acquia-drupal/) and are using PHP 5.3 and Mac OS X 10.6. You may need to modifythe command to use different paths for your environment.

Acquia Dev Desktop is compiled in OS X 10.5 compatibility mode to ensure that it works with OS X 10.5 andlater. Because of this, you must build your PHP extensions to be compatible with OS X 10.5. The -mmacosx-version-min=10.5 flag sets this compatibility in the commands below.

Set the -isysroot flag to the location of your Mac OS X SDK.

For Mac OS X 10.6 installed in the default location, use -isysroot/Applications/Xcode.app/Contents/Developer/Platforms/MacOSX.platform/Developer/SDKs/MacOSX10.6.sdk

For Mac OS X 10.5 installed in the default location, use -isysroot/Developer/SDKs/MacOSX10.5.sdk.




















http://developer.apple.com/tools/xcode/

http://pecl.php.net/

http://pecl.php.net/package/lzf


$ /Applications/acquia-drupal/php5_3/bin/phpize

$ CFLAGS='-arch i386

-isysroot /Applications/Xcode.app/Contents/Developer/Platforms

/MacOSX.platform/Developer/SDKs/MacOSX10.6.sdk

-mmacosx-version-min=10.5'

./configure --with-php-config=/Applications/acquia-drupal/php5_3/bin/php-config

$ make

The make command creates a modules directory in the extension source directory that contains the newmodule.

4. Copy the module to the Dev Desktop extensions directory. To do this, use the following command:

Note: The following command example assumes you have installed Dev Desktop in its default location(/Applications/acquia-drupal/) and are using PHP 5.3. If you have installed it in another directory,modify the command to use the correct directory.

$ cp modules/*.so /Applications/acquia-drupal/php5_3/ext

5. The modules directory you copied in the previous step contains a .so file. To register the PHP extension,edit the Dynamic Extensions section of Dev Desktop's php.ini file to contain the following text:

extension=lzf.so

You can find the file in /Applications/acquia-drupal/php5_3/bin/.

6. Restart the Apache server using the main Stop/Start button on the Acquia Dev Desktop Control Panel.


WAS THIS HELPFUL?





Documentation

Acquia Cloud



Acquia Ready

Acquia Dev Desktop

Troubleshooting AcquiaDev Desktop

Acquia Lift


Acquia Search


Drupal Gardens


Mollom


Support Users Guide



Troubleshooting Acquia Dev DesktopThe following issues have been identified when using Acquia Dev Desktop:

Mysqldump on the command line fails (Mac OS X)Symptom - When exporting a website you have developed on Dev Desktop and a command like this fails toexport the database:

mysqldump -u [user] [databasename]

Solution - The mysqldump command needs more specific information in this case. Try the following command.Substitute the correct path to Dev Desktop on your computer for "path/to/Dev-Desktop/" and enter yourdatabase password when prompted:

./mysqldump -S /path/to/Dev-Desktop/install/mysql/data/mysql.sock \

-u [database username] -p [databasename]

"Non-English" characters in paths break Dev DesktopDo not use non-English characters in directory names when you import sites into Dev Desktop.

If you have components of your site in directories with accented characters in their names or files with thesame, it can break Dev Desktop. To make sure this doesn't happen, you should use file and directory namesthat contain only "standard" ASCII characters. Dev Desktop is currently unable to work with Cyrillic, accented,or other non-ASCII characters.

I forgot my username or passwordAfter you install Acquia Dev Desktop, go to the following file to find your admin username, password, site name,and all the other information you entered during installation:

[Applications or Program Files directory]/acquia-drupal/common/setup/setupvars

The MySQL username is drupaluser, with no password.

Manage my database displays error message (Mac OS X)In the Acquia Dev Desktop Control Panel for Mac, when you click Manage my database, phpMyAdmindisplays the following error message in your browser:

Forbidden. You don't have permission to access /phpmyadmin/main.php on this server.

Using a text editor, open Applications/acquia-drupal/apache/conf/httpd.conf, and in the followingsection:





















Options Indexes FollowSymLinks

AllowOverride All

Order allow,deny

Allow from locahost

replace localhost with 127.0.0.1.

After you save your changes to the file, stop and restart the Drupal stack in the Control Panel.

If you continue to have problems regarding this issue after making the change to the file, see the Acquia DevDesktop FAQ for details about how to obtain technical support.


WAS THIS HELPFUL?






Documentation

Acquia Cloud



Acquia Ready

Acquia Dev Desktop

Troubleshooting AcquiaDev Desktop

Acquia Dev DesktopFAQ

Acquia Lift


Acquia Search


Drupal Gardens


Mollom


Support Users Guide



Acquia Dev Desktop FAQIf I have a problem, how do I get technical support for AcquiaDev Desktop?

If you have problems with Dev Desktop, we encourage you to register with acquia.com and participate in theinstaller support forums, including the Windows, Mac and Windows Web Platform Installer forums.When you create a new forum post, include information from your installation directory. You can acquire thisinformation by running the diag script that resides in the installation directory(<InstallFolder>/common/diag or diag.cmd on Windows).Note: On Mac, the script requires root permissions. Use 'sudo ./diag' to acquire the information.This script collects the following information about your Dev Desktop installation and then packages theinformation into a file called acquia_dd_diag.zip in your home folder:

piscript.log

installer.log

Apache configuration and logs

MySQL configuration and logs

php ini

Full file listing of the stack and site folders

XMail spool (Windows only, and only if XMail is installed)These files contain helpful information for the troubleshooting process, and you can send this file to Acquiasupport as an email attached to a forum post.If you have an Acquia subscription that entitles you to file support tickets, you can also create a ticket aboutAcquia Dev Desktop support questions. Be sure to attach the previously mentioned log files.

What is the purpose of Acquia Dev Desktop?The Dev Desktop application is an easy way to get started with Acquia Drupal.

In just a few clicks, you have a full Acquia Drupal website up-and-running on your computer.

With a few clicks more, you can install as many as you need.

You can use these sites to evaluate Acquia Drupal, adding other Drupal components, testing workflowsand functionality, and even get things wrong without worrying about ruining a live, production website.

How do I update an existing Acquia Drupal site on mycomputer?

Dev Desktop can upgrade any local Acquia Drupal site (and the Acquia Drupal suite of modules) that wasoriginally created on it. It cannot update or upgrade other modules or other any sites imported into it.For complete upgrade instructions, see Upgrading Acquia Dev Desktop.

How do I install multiple, local Drupal sites?Dev Desktop supports multiple sites and has a simple wizard-type functionality for creating them quickly andeasily. For more information about installing multiple sites, see Adding additional local sites.

How do I delete an existing site and start over?Dev Desktop cannot overwrite a current local site, but if you need to start over for whatever reason, simply





















https://network.acquia.com/sign-up

https://network.acquia.com/acquia-network-subscriber-forums/acquia-drupal-stack-installers

http://network.acquia.com/acquia-network-subscriber-forums/acquia-drupal-stack-installers/windows-version

http://network.acquia.com/acquia-network-subscriber-forums/acquia-drupal-stack-installers/mac-os-x-version

http://network.acquia.com/acquia-network-subscriber-forums/acquia-drupal-stack-installers/microsoft-web-platform-installer-wpi

https://insight.acquia.com/support/tickets

https://docs.acquia.com/dev-desktop/upgrade


Troubleshooting Acquia DevDesktop

Acquia Lift

follow the instructions on how to delete a local site from the installer control panel in Adding additional localsites.

Can Dev Desktop be used for software other than Drupal?Dev Desktop's DAMP stack is built and optimized for Drupal testing and development. It might be possibleto hack Dev Desktop to run other PHP applications, but it is built with Drupal in mind and has a lot of Drupal-specific features. Running anything outside of Drupal is beyond what the tool is intended for — and clearlyout of scope in terms of Acquia support!

Can I upload my Acquia Dev Desktop site to Acquia Cloud?Yes! For more information, see Importing an existing site into Acquia Cloud.

WAS THIS HELPFUL?




https://docs.acquia.com/cloud/site/import

Documents

DOCUMENTATION Acquia Dev Desktop - Acquia Help Center