MAMP PRO is a configuration application that helps you set up and run the Apache web server and the MySQL database server. It also takes care of the configuration of different versions of PHP. It is the big brother of the free MAMP application. Both applications need the MAMP folder to run.

Note: MAMP PRO stores its databases in a different location than the MAMP application.

MAMP PRO is a configuration application that helps you set up and run the Apache web server and the MySQL database server. It also takes care of the configuration of different versions of PHP. It is the big brother of the free MAMP application. Both applications need the MAMP folder to run.

Note: MAMP PRO stores its databases in a different location than the MAMP application.

2.1 Installation requirements

To use MAMP PRO, your system must meet the following requirements:

  • A working MAMP installation (MAMP can be downloaded directly with the MAMP PRO installation package).
  • Apple OS X, version 10.6.6 or later.
  • A Mac with a 64-Bit-capable CPU.
  • A user account that is part of the Admin Group. Go to Preferences > Users & Groups to confirm this.

2.1 Installation requirements

To use MAMP PRO, your system must meet the following requirements:

  • A working MAMP installation (MAMP can be downloaded directly with the MAMP PRO installation package).
  • Apple OS X, version 10.6.6 or later.
  • A Mac with a 64-Bit-capable CPU.
  • A user account that is part of the Admin Group. Go to Preferences > Users & Groups to confirm this.

2.2 Installing and upgrading MAMP PRO

  • Download MAMP PRO from http://www.mamp.info.
  • Double click on the MAMP_MAMP_PRO_3.0.pkg file in your Downloads folder.
  • The System Installer will guide you through the installation process.
  • If the installer detects an existing MAMP folder it will rename the current MAMP folder to MAMP_current_date.
  • An existing “htdocs” folder will be moved to your new /Applications/MAMP folder.
  • Confirm that all data has been transferred correctly before starting MAMP PRO.
  • Your /Applications/MAMP_current_date folder can now be deleted. You may however keep it, so you can fall back to your original setup.
Note: You need administrator permissions to install MAMP PRO!

2.2 Installing and upgrading MAMP PRO

  • Download MAMP PRO from http://www.mamp.info.
  • Double click on the MAMP_MAMP_PRO_3.0.pkg file in your Downloads folder.
  • The System Installer will guide you through the installation process.
  • If the installer detects an existing MAMP folder it will rename the current MAMP folder to MAMP_current_date.
  • An existing “htdocs” folder will be moved to your new /Applications/MAMP folder.
  • Confirm that all data has been transferred correctly before starting MAMP PRO.
  • Your /Applications/MAMP_current_date folder can now be deleted. You may however keep it, so you can fall back to your original setup.
Note: You need administrator permissions to install MAMP PRO!

2.3 Uninstall

Use the MAMP PRO Uninstaller located in /Applications/MAMP PRO to remove MAMP PRO.

Drag the /Applications/MAMP folder to the Trash to complete uninstallation.

2.3 Uninstall

Use the MAMP PRO Uninstaller located in /Applications/MAMP PRO to remove MAMP PRO.

Drag the /Applications/MAMP folder to the Trash to complete uninstallation.

 

When the MAMP PRO application is launched for the first time its helper tools will be installed. You will be prompted to enter your admin password.

Click on the Start button in the title bar to launch Apache and MySQL. In the status display, the launch status of the server is displayed. The web server uses port 8888 by default. This port must be specified when calling the local web page in the browser, e.g.: http://localhost:8888!

Your default host for MAMP PRO is localhost. The files for localhost are initially located in the/Applications/MAMP/htdocs folder. See the Hosts section for more information on what a host is and how to create additional hosts.

 

When the MAMP PRO application is launched for the first time its helper tools will be installed. You will be prompted to enter your admin password.

Click on the Start button in the title bar to launch Apache and MySQL. In the status display, the launch status of the server is displayed. The web server uses port 8888 by default. This port must be specified when calling the local web page in the browser, e.g.: http://localhost:8888!

Your default host for MAMP PRO is localhost. The files for localhost are initially located in the/Applications/MAMP/htdocs folder. See the Hosts section for more information on what a host is and how to create additional hosts.

3.1 Main GUI Elements

  • WebStart

    Open the MAMP PRO start page of your local web server. Additional information about the MAMP PRO start page is in the ‘Hosts’ section.

  • Start/Stop

    Starts or stops the Apache and MySQL services of the MAMP PRO server.

  • Status

    The status display in the upper right corner shows the started services (Apache, MySQL and Dyn. DNS).

  • Revert

    Discards all changes, which have not already been confirmed with ‘Save’.

  • Save

    Save your changed settings.

3.1 Main GUI Elements

  • WebStart

    Open the MAMP PRO start page of your local web server. Additional information about the MAMP PRO start page is in the ‘Hosts’ section.

  • Start/Stop

    Starts or stops the Apache and MySQL services of the MAMP PRO server.

  • Status

    The status display in the upper right corner shows the started services (Apache, MySQL and Dyn. DNS).

  • Revert

    Discards all changes, which have not already been confirmed with ‘Save’.

  • Save

    Save your changed settings.

3.2 Meaning of Icons

Change a file location, including the location of the document root, or a log file.

Prepare an e-mail with the Xip.io URL of a host.

Modify the access rights of a document root folder.

Open a disk location in the Finder, or a host in the web browser.

Provide more information, including phpInfo().

Indicates that information is missing.

3.2 Meaning of Icons

Change a file location, including the location of the document root, or a log file.

Prepare an e-mail with the Xip.io URL of a host.

Modify the access rights of a document root folder.

Open a disk location in the Finder, or a host in the web browser.

Provide more information, including phpInfo().

Indicates that information is missing.

4.1 General

  • Ports

    Server programs, when addressed via the network, need to be assigned to a certain network port. This way, multiple server programs may run on one server machine. Every service has a default port: The Apache web server typically uses port 80, the MySQL database server utilises port 3306.

    These ports are configurable. The default configuration for MAMP PRO uses ports 8888, 8889 and 8890. That way, the MAMP servers can run alongside other servers installed on your Mac. Should ports 8888, 8889 or 8890 be in use by a different application, please change the values accordingly.

    The button Set ports to 80, 443 & 3306 will set the ports to the value commonly used on the internet. The button Set default MAMP ports will reset the ports for Apache and MySQL to 8888, 8889 and 8890.

  • Start Apache / MySQL as user

    Production servers typically use www/msql to run Apache and MySQL. These users may not have the right to access your files, therefore it’s generally a good idea to run them under your own username.

    Note: You should only start the servers with your own user name when the machine is adequately protected against malicious attacks from the internet. Malicious scripts on your server may enable unlimited access to your personal data.
  • Start Apache and MySQL at system start

    Apache and MySQL are started during startup of the OS, this means that the services are available before a user has logged into the system.

  • Start Apache and MySQL at startup of MAMP PRO

    The services will start automatically at startup of MAMP PRO.

  • Stop Apache and MySQL at shutdown of MAMP PRO

    The services will be stopped automatically when MAMP PRO shuts down.

  • Delete log files at server startup

    The log files will be emptied before startup of the services. That way only current entries will be in the log files.

  • Apache Error Log

    If any errors occur at startup or during execution of the Apache server, the messages will be saved in a log file.

4.1 General

  • Ports

    Server programs, when addressed via the network, need to be assigned to a certain network port. This way, multiple server programs may run on one server machine. Every service has a default port: The Apache web server typically uses port 80, the MySQL database server utilises port 3306.

    These ports are configurable. The default configuration for MAMP PRO uses ports 8888, 8889 and 8890. That way, the MAMP servers can run alongside other servers installed on your Mac. Should ports 8888, 8889 or 8890 be in use by a different application, please change the values accordingly.

    The button Set ports to 80, 443 & 3306 will set the ports to the value commonly used on the internet. The button Set default MAMP ports will reset the ports for Apache and MySQL to 8888, 8889 and 8890.

  • Start Apache / MySQL as user

    Production servers typically use www/msql to run Apache and MySQL. These users may not have the right to access your files, therefore it’s generally a good idea to run them under your own username.

    Note: You should only start the servers with your own user name when the machine is adequately protected against malicious attacks from the internet. Malicious scripts on your server may enable unlimited access to your personal data.
  • Start Apache and MySQL at system start

    Apache and MySQL are started during startup of the OS, this means that the services are available before a user has logged into the system.

  • Start Apache and MySQL at startup of MAMP PRO

    The services will start automatically at startup of MAMP PRO.

  • Stop Apache and MySQL at shutdown of MAMP PRO

    The services will be stopped automatically when MAMP PRO shuts down.

  • Delete log files at server startup

    The log files will be emptied before startup of the services. That way only current entries will be in the log files.

  • Apache Error Log

    If any errors occur at startup or during execution of the Apache server, the messages will be saved in a log file.

4.2 Hosts

4.2 Hosts

4.2.1 General Settings (Host)


MAMP PRO uses virtual hosts to allow Apache to serve different websites. The virtual host [localhost] is created by default and cannot be deleted. You can add an unlimited number of hosts allowing you to create one host per project. Every host can have it’s own directory to store html, php files, and images. This directory is called Document Root

The name of a host [server name] must be unique, often it’s practical to use a reverse domain naming scheme to easily identify them (e.g. use de.appsolute.mamp instead of mamp.appsolute.de). The unreversed name may conflict with an outside domain name.

To create a new host press the ‘Plus’ button at the bottom left of the screen. Replace the default host name. The second required field to complete the setup of a new host is a location for its files [document root].

Click on the folder icon to choose a document root. Use the Right Arrow button to open the folder in the Finder.

 

The document root is also known as the web root folder. MAMP PRO will automatically add an index.php file and a MAMP image to this location when Apache is restarted and the folder is empty.

Server name

The Server Name and Port number in combination must be unique within MAMP PRO. The host name may only contain letters and/or numbers, as well as dashes ("-"); but it may not begin or end with a "-" character. Names are not case-sensitive (upper and lower-case letters are not distinguished.)

If the servers are running you can use the Right Arrow button to open a host in your web browser.

 

 

IP Address

If this field is left empty or contains an ‘*’ Apache will use one of the computer’s IP addresses to access this host. If you want to choose which of the IP addresses should be associated with a host, then select it from the pop up menu. 

 

Port Number

Determine the port with which the virtual host is accessible. Valid values are from 1 to 65535. In most cases the preset value does not need to be changed.

PHP version

Determine which version of PHP a host will use. This can only be set when Individual PHP version for every host (CGI) is set in the PHP section of MAMP PRO.

If you select the Standard PHP version MAMP PRO will automatically adapt this setting if you choose a new standard version in the PHP tab. Use a fixed setting to tell MAMP PRO not to alter the PHP version.

Sounds complicated? Let’s take a look at an example: The default version is set to 5.5.9. You have oneHost set to PHP version “Default (5.5.9)”, anotherHost set to “5.5.9” and yetAnotherHost set to “5.3.28”. If you set the PHP version in the PHP section to 5.4.25, MAMP PRO will adapt the PHP version of oneHost to this version (it is set to always use the standard version). The other 2 hosts will not be changed.

 

 

The button will open up a webpage with information about the PHP version used, including all its extensions.

 

Dynamic DNS

Determines, if this virtual host is accessible with the Dynamic DNS service from the internet.

 

Name resolution

This will determine how your system will map host names to ip addresses.

 

via/etc host file (this Mac only)

The basic mapping mechanism which uses the the file /etc/hosts.

 

via Xip.io (LAN only)

Allow other computers on your local network to access your web site. Using the Share button you can send the Xip.io address to other users.

 

Note: The Xip.io addresses will only work in your local network. They are temporary and may become invalid if you restart your Mac. Also make sure that your Internet router is not blocking Xip.io calls by using a DNS Rebind protection. If the router does this you can either deactivate this function, add Xip.io as an exception or not use the router as DNS server in your Macs network settings.

 

Document root

The location of the documents (HTML/PHP files etc.) of a virtual host is called a document root.

 

Alias Name

Aliases are additional names for your virtual host. The same constraints apply to these additional names as to the host itself. Add aliases with the plus-button. 

 

Access Rights for Document Root Directory

For Apache to be able to access the files inside the document root folder and serve them to a web browser it needs adequate rights. If you use the user www to start Apache, then this user must have the right to access the files inside the document root folder. Typically this is not the case. You can either adapt the access rights or use the current Mac user to start Apache.

 

During the development phase of a site it is easier to use the current Mac user to start Apache. The user www is generally only used on production servers.

 

If Apache is reporting “access denied” in its error log or parts of your web pages are missing this might be due to access rights problems. 

 

The rights dialog of MAMP PRO looks complicated at first sight but is actually very powerful. Not only does it show you the access rights of the document root folder but also all the rights of all the subdirectories and files inside it. A “-“ indicates that not all objects have the same rights.

 

Owner

The user who owns the directory and all the subdirectories and files in it.

  

Group

The group who has access to the directory and all the subdirectories and files in it.

 

Access Rights

You can change directory and files access rights separately.

4.2.1 General Settings (Host)


MAMP PRO uses virtual hosts to allow Apache to serve different websites. The virtual host [localhost] is created by default and cannot be deleted. You can add an unlimited number of hosts allowing you to create one host per project. Every host can have it’s own directory to store html, php files, and images. This directory is called Document Root

The name of a host [server name] must be unique, often it’s practical to use a reverse domain naming scheme to easily identify them (e.g. use de.appsolute.mamp instead of mamp.appsolute.de). The unreversed name may conflict with an outside domain name.

To create a new host press the ‘Plus’ button at the bottom left of the screen. Replace the default host name. The second required field to complete the setup of a new host is a location for its files [document root].

Click on the folder icon to choose a document root. Use the Right Arrow button to open the folder in the Finder.

 

The document root is also known as the web root folder. MAMP PRO will automatically add an index.php file and a MAMP image to this location when Apache is restarted and the folder is empty.

Server name

The Server Name and Port number in combination must be unique within MAMP PRO. The host name may only contain letters and/or numbers, as well as dashes ("-"); but it may not begin or end with a "-" character. Names are not case-sensitive (upper and lower-case letters are not distinguished.)

If the servers are running you can use the Right Arrow button to open a host in your web browser.

 

 

IP Address

If this field is left empty or contains an ‘*’ Apache will use one of the computer’s IP addresses to access this host. If you want to choose which of the IP addresses should be associated with a host, then select it from the pop up menu. 

 

Port Number

Determine the port with which the virtual host is accessible. Valid values are from 1 to 65535. In most cases the preset value does not need to be changed.

PHP version

Determine which version of PHP a host will use. This can only be set when Individual PHP version for every host (CGI) is set in the PHP section of MAMP PRO.

If you select the Standard PHP version MAMP PRO will automatically adapt this setting if you choose a new standard version in the PHP tab. Use a fixed setting to tell MAMP PRO not to alter the PHP version.

Sounds complicated? Let’s take a look at an example: The default version is set to 5.5.9. You have oneHost set to PHP version “Default (5.5.9)”, anotherHost set to “5.5.9” and yetAnotherHost set to “5.3.28”. If you set the PHP version in the PHP section to 5.4.25, MAMP PRO will adapt the PHP version of oneHost to this version (it is set to always use the standard version). The other 2 hosts will not be changed.

 

 

The button will open up a webpage with information about the PHP version used, including all its extensions.

 

Dynamic DNS

Determines, if this virtual host is accessible with the Dynamic DNS service from the internet.

 

Name resolution

This will determine how your system will map host names to ip addresses.

 

via/etc host file (this Mac only)

The basic mapping mechanism which uses the the file /etc/hosts.

 

via Xip.io (LAN only)

Allow other computers on your local network to access your web site. Using the Share button you can send the Xip.io address to other users.

 

Note: The Xip.io addresses will only work in your local network. They are temporary and may become invalid if you restart your Mac. Also make sure that your Internet router is not blocking Xip.io calls by using a DNS Rebind protection. If the router does this you can either deactivate this function, add Xip.io as an exception or not use the router as DNS server in your Macs network settings.

 

Document root

The location of the documents (HTML/PHP files etc.) of a virtual host is called a document root.

 

Alias Name

Aliases are additional names for your virtual host. The same constraints apply to these additional names as to the host itself. Add aliases with the plus-button. 

 

Access Rights for Document Root Directory

For Apache to be able to access the files inside the document root folder and serve them to a web browser it needs adequate rights. If you use the user www to start Apache, then this user must have the right to access the files inside the document root folder. Typically this is not the case. You can either adapt the access rights or use the current Mac user to start Apache.

 

During the development phase of a site it is easier to use the current Mac user to start Apache. The user www is generally only used on production servers.

 

If Apache is reporting “access denied” in its error log or parts of your web pages are missing this might be due to access rights problems. 

 

The rights dialog of MAMP PRO looks complicated at first sight but is actually very powerful. Not only does it show you the access rights of the document root folder but also all the rights of all the subdirectories and files inside it. A “-“ indicates that not all objects have the same rights.

 

Owner

The user who owns the directory and all the subdirectories and files in it.

  

Group

The group who has access to the directory and all the subdirectories and files in it.

 

Access Rights

You can change directory and files access rights separately.

4.2.2 Extended (Host)

Extended options can be set for the selected virtual host in the table. These options are security relevant!

 

Options for <Directory> directive

 

Indexes

Activates or deactivates "directory browsing". If there is no index.html, index.php, etc in the document root, the content of the folder is displayed when this option is enabled. Without this option, nothing will be displayed or an error message will appear.

 

Includes

Allows the use of Server Side Includes (SSI).

 

FollowSymLinks

Allows the use of symbolic links as reference to documents in other directories. This is an elegant feature if you would like to reference to objects, that are outside of the directory tree (e.g. protocol files of the web server), but know you want to avoid the hiding of objects through the URL tree.

 

SymLinksIfOwnerMatch

Restricted version of "FollowSymLinks". Allows reference to objects via symbolic links only if the owner matches.

 

Exec-CGI

Permit CGI execution.

 

Multiviews

Allows the use or disabling of dynamic documents depending on the language.

 

Directory Index

Determine which file Apache should serve if no filename is given in a address. By default it is either index.html or index.php.

 

Server admin

The e-mail address Apache will send error messages to.

 

Additional parameters for <Directory>

Additional Parameters for <VirtualHost>

These directives go directly to the httpd.conf file. 

 

Note: Watch out for typos, they will otherwise prevent Apache from starting up.

 

4.2.2 Extended (Host)

Extended options can be set for the selected virtual host in the table. These options are security relevant!

 

Options for <Directory> directive

 

Indexes

Activates or deactivates "directory browsing". If there is no index.html, index.php, etc in the document root, the content of the folder is displayed when this option is enabled. Without this option, nothing will be displayed or an error message will appear.

 

Includes

Allows the use of Server Side Includes (SSI).

 

FollowSymLinks

Allows the use of symbolic links as reference to documents in other directories. This is an elegant feature if you would like to reference to objects, that are outside of the directory tree (e.g. protocol files of the web server), but know you want to avoid the hiding of objects through the URL tree.

 

SymLinksIfOwnerMatch

Restricted version of "FollowSymLinks". Allows reference to objects via symbolic links only if the owner matches.

 

Exec-CGI

Permit CGI execution.

 

Multiviews

Allows the use or disabling of dynamic documents depending on the language.

 

Directory Index

Determine which file Apache should serve if no filename is given in a address. By default it is either index.html or index.php.

 

Server admin

The e-mail address Apache will send error messages to.

 

Additional parameters for <Directory>

Additional Parameters for <VirtualHost>

These directives go directly to the httpd.conf file. 

 

Note: Watch out for typos, they will otherwise prevent Apache from starting up.

 

4.2.3 SSL (Host)

To encrypt traffic from Apache to a web browser you can use SSL.

Use “Create self-signed certificate” if you want to test SSL functionality.

If you want to secure a productive server you should get the Certificate file and the Certificate key file from a Certified Authority (CA).

4.2.3 SSL (Host)

To encrypt traffic from Apache to a web browser you can use SSL.

Use “Create self-signed certificate” if you want to test SSL functionality.

If you want to secure a productive server you should get the Certificate file and the Certificate key file from a Certified Authority (CA).

4.2.4 Extras (Host)

MAMP PRO allows you to easily add popular packages to your hosts which we call Extras. Extras will always be loaded from the appsolute servers if you have an Internet connection. Over time more Extras will become available.

 

 

Note: The availability of an Extra will be affected by your hosts PHP version, Internet connection, cached Extras and available disk space.To add an Extra, press the plus button on the lower left side of the ‘Extras’ panel. The plus button has a red circle around it if you have no Extras installed.

 

4.2.4 Extras (Host)

MAMP PRO allows you to easily add popular packages to your hosts which we call Extras. Extras will always be loaded from the appsolute servers if you have an Internet connection. Over time more Extras will become available.

 

 

Note: The availability of an Extra will be affected by your hosts PHP version, Internet connection, cached Extras and available disk space.To add an Extra, press the plus button on the lower left side of the ‘Extras’ panel. The plus button has a red circle around it if you have no Extras installed.

 

4.2.4.1. Wordpress

Name of the blog:

Name your blog.

Email address:

Your email address.

Note: You must enter a valid email address to setup a Wordpress installation.

Directory:

The installation directory. If it is left blank the Wordpress files will be copied directly to the document root folder.

Note: Do not install over a previous installation of Wordpress! Files will be overwritten without warning

Database name:

Set the name of your database schema which will be added to your local database. After installation you can view this database for this instance of Wordpress using phpMyAdmin, Sequel Pro, or MySQLWorkbench. 

 

Username:

The Wordpress admin.

 

Note: You will need this username to login into your new of Wordpress blog, please write this down.

 

Password:

The Wordpress admins default password.

 

Note: You will need this password to login into your new Wordpress blog, please write this down.

 

4.2.4.1. Wordpress

Name of the blog:

Name your blog.

Email address:

Your email address.

Note: You must enter a valid email address to setup a Wordpress installation.

Directory:

The installation directory. If it is left blank the Wordpress files will be copied directly to the document root folder.

Note: Do not install over a previous installation of Wordpress! Files will be overwritten without warning

Database name:

Set the name of your database schema which will be added to your local database. After installation you can view this database for this instance of Wordpress using phpMyAdmin, Sequel Pro, or MySQLWorkbench. 

 

Username:

The Wordpress admin.

 

Note: You will need this username to login into your new of Wordpress blog, please write this down.

 

Password:

The Wordpress admins default password.

 

Note: You will need this password to login into your new Wordpress blog, please write this down.

 

4.2.4.2 Joomla

Joomla installations can share a single MySQL database if you provide a unique table prefix during installation. To use an existing database enter the name of the database and a unique table prefix. To create a new database use a unique database name, table prefix must not be empty.

Table prefix:

Set the name of your database schema prefix. Joomla offers the ability to manage multiple websites using a single database schema. 

Database name:

Set the name of your database schema which will be added to your local database. After installation you can view this database for this instance of Joomla using phpMyAdmin, Sequel Pro, or MySQLWorkbench. 

4.2.4.2 Joomla

Joomla installations can share a single MySQL database if you provide a unique table prefix during installation. To use an existing database enter the name of the database and a unique table prefix. To create a new database use a unique database name, table prefix must not be empty.

Table prefix:

Set the name of your database schema prefix. Joomla offers the ability to manage multiple websites using a single database schema. 

Database name:

Set the name of your database schema which will be added to your local database. After installation you can view this database for this instance of Joomla using phpMyAdmin, Sequel Pro, or MySQLWorkbench. 

4.2.4.3 webEdition

webEdition will always be installed in a folder called webedition inside the document root folder.

 

Table prefix:

Set the name of your database schema prefix. webEdition offers the ability to manage multiple websites using a single database schema.

Database name:

Set the name of your database schema which will be added to your local database. After installation you can view this database for this instance of webEdition using phpMyAdmin, Sequel Pro, or MySQLWorkbench. 

 

Note: When a Content Management System is setup the host name and Apache port number is stored in its database. Going forward the Apache port in MAMP PRO cannot be changed. A change in the Apache port will result in breaking the CMS, returning only a vague error message. Content Management Systems usually provide a mechanism for changing the host and port names. If changes are made in the CMS, then they must also be made in MAMP PRO.

 

4.2.4.3 webEdition

webEdition will always be installed in a folder called webedition inside the document root folder.

 

Table prefix:

Set the name of your database schema prefix. webEdition offers the ability to manage multiple websites using a single database schema.

Database name:

Set the name of your database schema which will be added to your local database. After installation you can view this database for this instance of webEdition using phpMyAdmin, Sequel Pro, or MySQLWorkbench. 

 

Note: When a Content Management System is setup the host name and Apache port number is stored in its database. Going forward the Apache port in MAMP PRO cannot be changed. A change in the Apache port will result in breaking the CMS, returning only a vague error message. Content Management Systems usually provide a mechanism for changing the host and port names. If changes are made in the CMS, then they must also be made in MAMP PRO.

 

4.3 Modules (Apache)

 

The Apache Web Server installed by MAMP PRO comes with many modules pre-installed.

 

Apache Modules

The web server modules can be activated or deactivated depending on your needs. Module Description provides information pertaining to features and functions of the selected module.

 

If you want to use the PHP scripting language you must activate the php_module, if you want to use Python you need mod_wsgi module, Perl needs perl_module.

If you want to be able to switch to CGI mode and use multiple PHP versions you must activate cgi_module.

4.3 Modules (Apache)

 

The Apache Web Server installed by MAMP PRO comes with many modules pre-installed.

 

Apache Modules

The web server modules can be activated or deactivated depending on your needs. Module Description provides information pertaining to features and functions of the selected module.

 

If you want to use the PHP scripting language you must activate the php_module, if you want to use Python you need mod_wsgi module, Perl needs perl_module.

If you want to be able to switch to CGI mode and use multiple PHP versions you must activate cgi_module.

4.4 PHP

PHP is a popular web scripting programming language. MAMP PRO installs several versions of the PHP script interpreter.

 

Default version

Choose which PHP version to use.

 

Mode

Choose whether to use identical PHP versions for all hosts [Module Mode] or on a host by host basis [CGI Mode]. In CGI Mode the PHP settings will be identical for all hosts – except for the PHP version. Navigate to the Hosts section to change the PHP version for each individual host. More information on how to change the PHP version for an individual host is covered in the ‘Hosts’ section.

 

Cache Module to speed up PHP execution

PHP has several cache extensions that can help speed up execution in certain circumstances. This is set to ‘off’ by default. Enabling a cache extension does not necessarily translate to greater execution speed.

 

Debugger

 

Activate Xdebug

Activate Xdebug to allow PHP to create debugging information during script execution. By default, Xdebug uses localhost and port 9000 in the PHP.ini file.

 

Open MacGDBp

With Xdebug activated you can open the MacGDBp debugger to enable PHP debugging. By default, MacGDBp expects debugging information on port 9000 of localhost. See http://www.bluestatic.org/software/macgdbp/ for more information.

 

What to log

Determine which error types should be reported.

   

Display startup errors: Log PHP errors that occur when Apache loads the PHP module. 

All errors and warnings: All errors will be reported.

Errors: Script errors that make the further execution of the current PHP script impossible.

Warnings: General errors in the PHP environment.

Notices: Possible problems, that do not concern PHP, but which could be a notice of an error in a script.

Other: Report further error types through constants. Please turn to the PHP documentation for further information.

 

Log Errors

Determine if these errors should be recorded in a log file and/or displayed in the web browser window.

4.4 PHP

PHP is a popular web scripting programming language. MAMP PRO installs several versions of the PHP script interpreter.

 

Default version

Choose which PHP version to use.

 

Mode

Choose whether to use identical PHP versions for all hosts [Module Mode] or on a host by host basis [CGI Mode]. In CGI Mode the PHP settings will be identical for all hosts – except for the PHP version. Navigate to the Hosts section to change the PHP version for each individual host. More information on how to change the PHP version for an individual host is covered in the ‘Hosts’ section.

 

Cache Module to speed up PHP execution

PHP has several cache extensions that can help speed up execution in certain circumstances. This is set to ‘off’ by default. Enabling a cache extension does not necessarily translate to greater execution speed.

 

Debugger

 

Activate Xdebug

Activate Xdebug to allow PHP to create debugging information during script execution. By default, Xdebug uses localhost and port 9000 in the PHP.ini file.

 

Open MacGDBp

With Xdebug activated you can open the MacGDBp debugger to enable PHP debugging. By default, MacGDBp expects debugging information on port 9000 of localhost. See http://www.bluestatic.org/software/macgdbp/ for more information.

 

What to log

Determine which error types should be reported.

   

Display startup errors: Log PHP errors that occur when Apache loads the PHP module. 

All errors and warnings: All errors will be reported.

Errors: Script errors that make the further execution of the current PHP script impossible.

Warnings: General errors in the PHP environment.

Notices: Possible problems, that do not concern PHP, but which could be a notice of an error in a script.

Other: Report further error types through constants. Please turn to the PHP documentation for further information.

 

Log Errors

Determine if these errors should be recorded in a log file and/or displayed in the web browser window.

4.5 MySQL

The MySQL database server is a popular database used on production servers. An installation of MySQL is installed on your computer by MAMP PRO.

 

Change password of user “root”

The Head Database Administrator is called root. This user has unlimited access to all databases. Therefore you should set the password to one only you know.

Note: The default password of root is “root". To make things even more confusing there is also a user root inside Mac OS X. Don’t confuse them. You can also use one of the MySQL administration tools to create other MySQL users if you do not want to use almighty root.

 

Allow network access to MySQL

If the checkbox for Allow network access to MySQL is not checked, network access to the database is prohibited, even from programs installed locally.

 

Note: This is an advanced feature not need for local development.

 

Only from this Mac

Only programs installed on this Mac can access MySQL via network functions.

 

From other computers

MySQL will answer any network request, even from computers on the internet, depending on you network settings.

 

Path to MySQL log file

Errors occurring at startup or during execution of the MySQL server will be saved in this log file.

 

Administer MySQL 

MAMP PRO comes pre-installed with several MySQL administration tools.

phpMyAdmin is a web-based administrational tool. It allows you to change data and perform administrative duties like creating new databases.

Sequel Pro is a native Mac application. It allows you to create and visualise database schemas in addition to administrative duties.

MySQL Workbench is also a native Mac application from the makers of MySQL. It allows you to visually create database schemas in addition to administrative duties.

 

4.5 MySQL

The MySQL database server is a popular database used on production servers. An installation of MySQL is installed on your computer by MAMP PRO.

 

Change password of user “root”

The Head Database Administrator is called root. This user has unlimited access to all databases. Therefore you should set the password to one only you know.

Note: The default password of root is “root". To make things even more confusing there is also a user root inside Mac OS X. Don’t confuse them. You can also use one of the MySQL administration tools to create other MySQL users if you do not want to use almighty root.

 

Allow network access to MySQL

If the checkbox for Allow network access to MySQL is not checked, network access to the database is prohibited, even from programs installed locally.

 

Note: This is an advanced feature not need for local development.

 

Only from this Mac

Only programs installed on this Mac can access MySQL via network functions.

 

From other computers

MySQL will answer any network request, even from computers on the internet, depending on you network settings.

 

Path to MySQL log file

Errors occurring at startup or during execution of the MySQL server will be saved in this log file.

 

Administer MySQL 

MAMP PRO comes pre-installed with several MySQL administration tools.

phpMyAdmin is a web-based administrational tool. It allows you to change data and perform administrative duties like creating new databases.

Sequel Pro is a native Mac application. It allows you to create and visualise database schemas in addition to administrative duties.

MySQL Workbench is also a native Mac application from the makers of MySQL. It allows you to visually create database schemas in addition to administrative duties.

 

4.6 Dynamic DNS

If you would like to make your hosts accessible from the internet (Don’t forget about security then!), but do not have a domain name that points to your Mac, you will need a Dynamic DNS Service. 

If your network is connected to the internet via a router and it can handle Dynamic DNS Services, then you don’t need to configure it with MAMP PRO. 

Otherwise you will need to register with a Dynamic DNS Service and enter the username and password into the appropriate fields. Then you will need to tell MAMP PRO when to inform the Dynamic DNS provider about a change in your Macs IP address. It may be necessary when you restart your computer or a DSL/Cable modem re/establishes a connection.

 

 

Note: To use the Dynamic DNS functions, you will need to register with one of the supported providers. This is independent of MAMP PRO and is not a service provided by appsolute GmbH.

 

User name

Enter the user name that was given to you by the provider of the Dynamic DNS Service.

 

Password

Enter the password that was given to you by the provider of the Dynamic DNS Service.

 

Activate Dynamic DNS Service 

 

Never (don’t use Dynamic DNS Service)

Deactivate the "Dynamic DNS" service.

 

Automatically, when Apache starts and quits

Starts the "Dynamic DNS" service with the start of the Apache server.

 

Permanently (as a System Service running in the background)

Starts the "Dynamic DNS" service with the operating system. Only use this when your servers are running 24/7.

 

Path to Dynamic DNS Log file

All the events of the Dynamic DNS service will be recorded in a log file.

 

4.6 Dynamic DNS

If you would like to make your hosts accessible from the internet (Don’t forget about security then!), but do not have a domain name that points to your Mac, you will need a Dynamic DNS Service. 

If your network is connected to the internet via a router and it can handle Dynamic DNS Services, then you don’t need to configure it with MAMP PRO. 

Otherwise you will need to register with a Dynamic DNS Service and enter the username and password into the appropriate fields. Then you will need to tell MAMP PRO when to inform the Dynamic DNS provider about a change in your Macs IP address. It may be necessary when you restart your computer or a DSL/Cable modem re/establishes a connection.

 

 

Note: To use the Dynamic DNS functions, you will need to register with one of the supported providers. This is independent of MAMP PRO and is not a service provided by appsolute GmbH.

 

User name

Enter the user name that was given to you by the provider of the Dynamic DNS Service.

 

Password

Enter the password that was given to you by the provider of the Dynamic DNS Service.

 

Activate Dynamic DNS Service 

 

Never (don’t use Dynamic DNS Service)

Deactivate the "Dynamic DNS" service.

 

Automatically, when Apache starts and quits

Starts the "Dynamic DNS" service with the start of the Apache server.

 

Permanently (as a System Service running in the background)

Starts the "Dynamic DNS" service with the operating system. Only use this when your servers are running 24/7.

 

Path to Dynamic DNS Log file

All the events of the Dynamic DNS service will be recorded in a log file.

 

4.7 Postfix

Sometimes you may need to send an email with PHP. To do so you have to configure and start Postfix. An easy way getting Postfix to run is using the configuration tool built into MAMP PRO.

 

Set domain of outgoing e-mails to

If you want to use the PHP function mail() for sending emails to your own email address (like mail@johndoe.com) you just need to open MAMP PRO, go to Server -> Postfix and add the value "johndoe.com" (without quotes and the according domain name) into the field "Domain of outgoing mail”. Only if you want to send e-mail to others you will need to fill in the other fields. In this case make sure that your e-mail provider allows the use of a Smart host.

 

Server name
Fill in your server name for outgoing emails. This could be for instance "smtp.johndoe.com" (without quotes). Ask your provider if you are unsure about the server name.

 

User

Add the user name of your mail account.

 

Password

Add the password for your email user account.

 

Authentication

Leave to “None"

 

Note: Some providers do not allow Smart-Hosts, like Google Mail.

4.7 Postfix

Sometimes you may need to send an email with PHP. To do so you have to configure and start Postfix. An easy way getting Postfix to run is using the configuration tool built into MAMP PRO.

 

Set domain of outgoing e-mails to

If you want to use the PHP function mail() for sending emails to your own email address (like mail@johndoe.com) you just need to open MAMP PRO, go to Server -> Postfix and add the value "johndoe.com" (without quotes and the according domain name) into the field "Domain of outgoing mail”. Only if you want to send e-mail to others you will need to fill in the other fields. In this case make sure that your e-mail provider allows the use of a Smart host.

 

Server name
Fill in your server name for outgoing emails. This could be for instance "smtp.johndoe.com" (without quotes). Ask your provider if you are unsure about the server name.

 

User

Add the user name of your mail account.

 

Password

Add the password for your email user account.

 

Authentication

Leave to “None"

 

Note: Some providers do not allow Smart-Hosts, like Google Mail.

5.1 MAMP PRO

Check For Updates

Check MAMP PRO updates checks for updates to the MAMP PRO application. It does not check for new versions of individual components.

 

Preferences…

Open WebStart when starting MAMP PRO

Your default browser will bring up the web start page when MAMP PRO is launched.

 

Path To Webstart

The default MAMP start page provides links to access utilities such as phpMyAdmin, phpInfo, SQLite Manager, phpLiteAdmin, FAQ, and the MAMP Website. 

 When left using the default setting (/MAMP/), you will be directed to the MAMP PRO utilities start page using the Alias definition /MAMP/. If this field is left blank, you will be taken to your default document root (http://localhost:8888 in the /Applications/MAMP/htdocs). If you enter /subDirectory in this field, you will be taken to the /Applications/MAMP/htdocs/subDirectory folder via your default web browser (http://localhost:8888/subDirectory).

 

Allow Saving when Document Root is invalid

MAMP PRO will ignore invalid paths to hosts and proceed with saving your settings.

 

Allow Saving when IP Address is invalid

MAMP PRO will ignore invalid IP addresses for hosts and proceed with saving your settings.

 

Note: Setting these options may prevent Apache from starting up.

 

Automatically Restart Servers if necessary (don’t ask)

MAMP PRO will automatically restart when changes are made that require a restart.

 

Keyboard shortcut for MAMP

Only M cannot be used as a shortcut key. The ^ key stands for the ctrl key.

 

Show Status in Menu Bar

The elephant icon will appear in the Menu Bar. When MAMP PRO has the servers running the elephant icon will be blue, when the servers are not running the elephant will be black.

 

Hide Doc Icon (OS X 10.7 or later)

The Doc Icon will be hidden. This option will only take affect after the restart of MAMP PRO.

 

Note: You will not be able to see the MAMP PRO Menu Bar.

 

Use Message Center (OS X 10.9 or later)

The Message Center will inform you of when Apache and MySQL have started. The Message Center can only be used when the doc icon is hidden.

 

 

5.1 MAMP PRO

Check For Updates

Check MAMP PRO updates checks for updates to the MAMP PRO application. It does not check for new versions of individual components.

 

Preferences…

Open WebStart when starting MAMP PRO

Your default browser will bring up the web start page when MAMP PRO is launched.

 

Path To Webstart

The default MAMP start page provides links to access utilities such as phpMyAdmin, phpInfo, SQLite Manager, phpLiteAdmin, FAQ, and the MAMP Website. 

 When left using the default setting (/MAMP/), you will be directed to the MAMP PRO utilities start page using the Alias definition /MAMP/. If this field is left blank, you will be taken to your default document root (http://localhost:8888 in the /Applications/MAMP/htdocs). If you enter /subDirectory in this field, you will be taken to the /Applications/MAMP/htdocs/subDirectory folder via your default web browser (http://localhost:8888/subDirectory).

 

Allow Saving when Document Root is invalid

MAMP PRO will ignore invalid paths to hosts and proceed with saving your settings.

 

Allow Saving when IP Address is invalid

MAMP PRO will ignore invalid IP addresses for hosts and proceed with saving your settings.

 

Note: Setting these options may prevent Apache from starting up.

 

Automatically Restart Servers if necessary (don’t ask)

MAMP PRO will automatically restart when changes are made that require a restart.

 

Keyboard shortcut for MAMP

Only M cannot be used as a shortcut key. The ^ key stands for the ctrl key.

 

Show Status in Menu Bar

The elephant icon will appear in the Menu Bar. When MAMP PRO has the servers running the elephant icon will be blue, when the servers are not running the elephant will be black.

 

Hide Doc Icon (OS X 10.7 or later)

The Doc Icon will be hidden. This option will only take affect after the restart of MAMP PRO.

 

Note: You will not be able to see the MAMP PRO Menu Bar.

 

Use Message Center (OS X 10.9 or later)

The Message Center will inform you of when Apache and MySQL have started. The Message Center can only be used when the doc icon is hidden.

 

 

5.2 File

Edit Template
MAMP PRO uses templates to create the necessary server config files. You can edit these templates from the menu item File > Edit template. Here, you have access to options which are not accessible from the MAMP PRO user interface.

 

Note:Edition errors in the templates of the configuration files can cause the servers not to start. This could mean that you will have to reset the settings for MAMP PRO, and you may lose all your other custom settings. You should edit these templates only if you are familiar with the exact syntax and meaning of the options.

 

Factory Settings

Development

Development will reset all your host and server settings back to default, including setting your Apache ports back to 8888, 8890, 8889, and your Apache User/MySQL User to username/username.

Live
Live will reset all your host and server settings back to default, including setting your ports back to 80, 440, 3306, and your Apache User/MySQL User to www/mysql.

Backup…

Make a backup of all your host settings and database files.

Note: The backup feature makes a backup of your current host settings. It will not back up the files(.php, .html, .js etc…) in a hosts document root! 

Restore From Backup

Restore your host settings and MySQL database files.

 

5.2 File

Edit Template
MAMP PRO uses templates to create the necessary server config files. You can edit these templates from the menu item File > Edit template. Here, you have access to options which are not accessible from the MAMP PRO user interface.

 

Note:Edition errors in the templates of the configuration files can cause the servers not to start. This could mean that you will have to reset the settings for MAMP PRO, and you may lose all your other custom settings. You should edit these templates only if you are familiar with the exact syntax and meaning of the options.

 

Factory Settings

Development

Development will reset all your host and server settings back to default, including setting your Apache ports back to 8888, 8890, 8889, and your Apache User/MySQL User to username/username.

Live
Live will reset all your host and server settings back to default, including setting your ports back to 80, 440, 3306, and your Apache User/MySQL User to www/mysql.

Backup…

Make a backup of all your host settings and database files.

Note: The backup feature makes a backup of your current host settings. It will not back up the files(.php, .html, .js etc…) in a hosts document root! 

Restore From Backup

Restore your host settings and MySQL database files.

 

5.3 Log

The MAMP server record events like errors in so-called log files. Use the MAMP PRO menu to display the content of these files.

5.3 Log

The MAMP server record events like errors in so-called log files. Use the MAMP PRO menu to display the content of these files.

5.4 Tools

Extras

Go directly to the Extras pane of the last selected host.

 

Verify MySQL Databases

Get a complete list of schemas and tables inside of your MySQL Database. The database must be running in order for this function to work.

 

Repair MySQL Databases

Runs mysqlcheck which performs table maintenance.

 

Update MySQL Databases

Update your databases. The server must be shutdown to use this function.

 

Save MySQL Databases

Make a backup of your databases. The server must be shutdown to use this function.

 

Show Hosts File

The hosts file is located in the /etc directory, it maps host names to the IP address of your Mac. The host file contains the host names. Host entries created by MAMP PRO are marked by “# MAMP PRO - Do NOT remove this entry!”. These will disappear when Apache is shut down.

 

Start System Apache / Web Sharing

Enable the Apache server that is included with Mac OS X.

5.4 Tools

Extras

Go directly to the Extras pane of the last selected host.

 

Verify MySQL Databases

Get a complete list of schemas and tables inside of your MySQL Database. The database must be running in order for this function to work.

 

Repair MySQL Databases

Runs mysqlcheck which performs table maintenance.

 

Update MySQL Databases

Update your databases. The server must be shutdown to use this function.

 

Save MySQL Databases

Make a backup of your databases. The server must be shutdown to use this function.

 

Show Hosts File

The hosts file is located in the /etc directory, it maps host names to the IP address of your Mac. The host file contains the host names. Host entries created by MAMP PRO are marked by “# MAMP PRO - Do NOT remove this entry!”. These will disappear when Apache is shut down.

 

Start System Apache / Web Sharing

Enable the Apache server that is included with Mac OS X.

6.1 What is MAMP PRO?

MAMP PRO is the commercial, professional grade version of the classic local server environment for Mac OS X: MAMP. Designed for professional web developers and programmers, MAMP PRO allows easy installation and administration of their development environment under Mac OS X.

6.1 What is MAMP PRO?

MAMP PRO is the commercial, professional grade version of the classic local server environment for Mac OS X: MAMP. Designed for professional web developers and programmers, MAMP PRO allows easy installation and administration of their development environment under Mac OS X.

6.2 Are updates free of charge?

Yes, all updates in the current major version (3.x) are free of charge. To update MAMP PRO from e.g. 3.1.2 to 3.9 just use the serial number you already have. Licenses are good forever, they are not on a subscription basis.

6.2 Are updates free of charge?

Yes, all updates in the current major version (3.x) are free of charge. To update MAMP PRO from e.g. 3.1.2 to 3.9 just use the serial number you already have. Licenses are good forever, they are not on a subscription basis.

6.3 Is MAMP PRO compatible with Mac OS X 10.9 (Mavericks)?

Yes, MAMP PRO is indeed compatible with Mac OS X 10.9 (Mavericks).

6.3 Is MAMP PRO compatible with Mac OS X 10.9 (Mavericks)?

Yes, MAMP PRO is indeed compatible with Mac OS X 10.9 (Mavericks).

6.4 Can I use MAMP at the same time as MAMP PRO?

Both applications, MAMP as well as MAMP PRO, are configuration tools for the tools inside the folder MAMP. Though you could run them simultaneously you should not do it. You would run into sporadic problems, even data loss may occur.

6.4 Can I use MAMP at the same time as MAMP PRO?

Both applications, MAMP as well as MAMP PRO, are configuration tools for the tools inside the folder MAMP. Though you could run them simultaneously you should not do it. You would run into sporadic problems, even data loss may occur.

6.5 Which PHP modules are included?

To find out which PHP modules are included click on the (i) button in the host section when the servers are running. It will open a web page showing information about the selected PHP software.

6.5 Which PHP modules are included?

To find out which PHP modules are included click on the (i) button in the host section when the servers are running. It will open a web page showing information about the selected PHP software.

6.6 Where do I find my registration number?

Open the dialog File/About MAMP PRO, it is shown there.

6.6 Where do I find my registration number?

Open the dialog File/About MAMP PRO, it is shown there.

6.7 Is it possible to add an updated version of PHP?

Compiled binaries of the PHP interpreter can be found at http://www.mamp.info/en/downloads/. Drop this downloaded folder into your /Applications/MAMP/bin/php directory. Close and re-open your MAMP PRO application. Your new PHP version should now appear in the PHP drop down menu. MAMP PRO will only support PHP versions from the downloads page.

6.7 Is it possible to add an updated version of PHP?

Compiled binaries of the PHP interpreter can be found at http://www.mamp.info/en/downloads/. Drop this downloaded folder into your /Applications/MAMP/bin/php directory. Close and re-open your MAMP PRO application. Your new PHP version should now appear in the PHP drop down menu. MAMP PRO will only support PHP versions from the downloads page.

6.8 Can the port assignment be the same for MAMP and MAMP PRO?

You can set the same ports for MAMP and MAMP PRO but it is not recommended to run both applications at the same time.

6.8 Can the port assignment be the same for MAMP and MAMP PRO?

You can set the same ports for MAMP and MAMP PRO but it is not recommended to run both applications at the same time.

6.9 Can I use MAMP at the same time as MAMP PRO?

Both applications, MAMP as well as MAMP PRO, are configuration tools for the tools inside the folder MAMP. Though you could run them simultaneously you should not do it. You would run into sporadic problems, even data loss may occur.

6.9 Can I use MAMP at the same time as MAMP PRO?

Both applications, MAMP as well as MAMP PRO, are configuration tools for the tools inside the folder MAMP. Though you could run them simultaneously you should not do it. You would run into sporadic problems, even data loss may occur.

6.10 Where should I store my HTML and PHP pages?

By default, PHP and HTML Pages should be stored inside the MAMP /Applications/MAMP/htdocs folder. This folder is called "Document Root". The location of the document root folder can be changed in the host settings.

6.10 Where should I store my HTML and PHP pages?

By default, PHP and HTML Pages should be stored inside the MAMP /Applications/MAMP/htdocs folder. This folder is called "Document Root". The location of the document root folder can be changed in the host settings.

6.11 Is the ImageMagick PHP module included?

The ImageMagick PHP module is included by default, but you must enable it inside the php.ini template file. Remove the ‘;’ from the following line.

;extension=imagick.so

6.11 Is the ImageMagick PHP module included?

The ImageMagick PHP module is included by default, but you must enable it inside the php.ini template file. Remove the ‘;’ from the following line.

;extension=imagick.so

6.12 Which Apache modules are included?

Apache modules are located in the /Applications/MAMP/Library/modules folder.

6.12 Which Apache modules are included?

Apache modules are located in the /Applications/MAMP/Library/modules folder.

6.13 Is it possible to install MAMP PRO on an external drive?

No, MAMP PRO (as well as MAMP) has to be installed on the system drive.

6.13 Is it possible to install MAMP PRO on an external drive?

No, MAMP PRO (as well as MAMP) has to be installed on the system drive.

6.14 Will MAMP work if the MAMP folder is not located in the Applications directory?

No. In order to work properly the MAMP folder has to be located in the Applications folder.

6.14 Will MAMP work if the MAMP folder is not located in the Applications directory?

No. In order to work properly the MAMP folder has to be located in the Applications folder.

6.15 Are the amount of virtual hosts aliases limited?

No, with MAMP PRO you can use as many hosts and aliases as you like.

6.15 Are the amount of virtual hosts aliases limited?

No, with MAMP PRO you can use as many hosts and aliases as you like.

6.16 Where can I find the log files?

Clicking the black right arrow will open the log file in the Console application.

6.16 Where can I find the log files?

Clicking the black right arrow will open the log file in the Console application.

6.17 Where exactly are the MAMP PRO files created or changed?

The following list contains all files which are created and changed by MAMP PRO and are not located within the MAMP PRO folder.

MAMP PRO Settings and Files

  • /Library/Application Support/appsolute/MAMP PRO
  • ~/Library/Application Support/appsolute/MAMP PRO
  • ~/Library/Preferences/de.appsolute.mamppro.plist

MySQL

  • /Library/Application Support/appsolute/MAMP PRO/db/mysql

Dynamic DNS

  • /Library/LaunchDaemons/de.appsolute.mamp_dyndns.plist
  • ~/Library/LaunchAgents/de.appsolute.mamp_dyndns.plist

Autostart at system start

  • /Library/StartupItems/MAMP/MAMP
  • /Library/StartupItems/MAMP/StartupParameters.plist

Postfix

  • An existing postfix configuration will be backed up to /etc/postfix/MAMP_backup before writing a new config file.

6.17 Where exactly are the MAMP PRO files created or changed?

The following list contains all files which are created and changed by MAMP PRO and are not located within the MAMP PRO folder.

MAMP PRO Settings and Files

  • /Library/Application Support/appsolute/MAMP PRO
  • ~/Library/Application Support/appsolute/MAMP PRO
  • ~/Library/Preferences/de.appsolute.mamppro.plist

MySQL

  • /Library/Application Support/appsolute/MAMP PRO/db/mysql

Dynamic DNS

  • /Library/LaunchDaemons/de.appsolute.mamp_dyndns.plist
  • ~/Library/LaunchAgents/de.appsolute.mamp_dyndns.plist

Autostart at system start

  • /Library/StartupItems/MAMP/MAMP
  • /Library/StartupItems/MAMP/StartupParameters.plist

Postfix

  • An existing postfix configuration will be backed up to /etc/postfix/MAMP_backup before writing a new config file.

7.1 The last time I opened Extras there was a Content Management System that is now not available?

This could be due to several reasons. Please check your Internet connection. If it is not working MAMP PRO will use only show Extras that you have previously installed. An Extra will be missing if the PHP version a host uses does not meet the requirements of an Extra. Do you have enough free disk space available? Some Extras can only be installed once per host. e.g. webEdition.

7.1 The last time I opened Extras there was a Content Management System that is now not available?

This could be due to several reasons. Please check your Internet connection. If it is not working MAMP PRO will use only show Extras that you have previously installed. An Extra will be missing if the PHP version a host uses does not meet the requirements of an Extra. Do you have enough free disk space available? Some Extras can only be installed once per host. e.g. webEdition.

7.2 My Content Management System stopped working without any indication of what is wrong?

Most content management systems store the host location, including the port number, in their database. If an CMS is setup with an Apache port of 8888, then this port must be used every time the CMS is used. Changing the port may result in a blank screen in your browser, and a vague error message.

7.2 My Content Management System stopped working without any indication of what is wrong?

Most content management systems store the host location, including the port number, in their database. If an CMS is setup with an Apache port of 8888, then this port must be used every time the CMS is used. Changing the port may result in a blank screen in your browser, and a vague error message.

7.3 I setup up Wordpress and it is asking for a username and password?

Your default Wordpress username and password when setup through MAMP PRO are admin/admin.

7.3 I setup up Wordpress and it is asking for a username and password?

Your default Wordpress username and password when setup through MAMP PRO are admin/admin.

7.4 My Apache Server will not start?

The most common problem with MySQL Server not starting is another mysql service running on the same port. To check this

  1. Quit MAMP PRO.
  2. Open the Activity Monitor located in your /Applications/Utilities folder.
  3. Type "mysqld" into the search field on the top right.
  4. Quit every process you find after your search.
  5. Restart MAMP PRO.

If Apache still refuses to start check the log file for error messages.

7.4 My Apache Server will not start?

The most common problem with MySQL Server not starting is another mysql service running on the same port. To check this

  1. Quit MAMP PRO.
  2. Open the Activity Monitor located in your /Applications/Utilities folder.
  3. Type "mysqld" into the search field on the top right.
  4. Quit every process you find after your search.
  5. Restart MAMP PRO.

If Apache still refuses to start check the log file for error messages.

You must include the port number when you type a your localhost url into the browser.

e.g. http://localhost:8888

What appears in your browser window thereafter may be shortened to localhost depending on the browser settings.

You must include the port number when you type a your localhost url into the browser.

e.g. http://localhost:8888

What appears in your browser window thereafter may be shortened to localhost depending on the browser settings.

7.6 Changes to my php.ini file and/or my httpd.conf file are not showing up when I restart MAMP PRO.

You must edit the httpd.conf, php.ini and my.cnf files through the Template Editor provided by MAMP PRO. Go to File->Edit Template to edit template files.

7.6 Changes to my php.ini file and/or my httpd.conf file are not showing up when I restart MAMP PRO.

You must edit the httpd.conf, php.ini and my.cnf files through the Template Editor provided by MAMP PRO. Go to File->Edit Template to edit template files.

7.7 My MySQL Server will not start?

The most common problem with MySQL Server not starting is another mysql service running on the same port. To check this 

 

- Quit MAMP PRO.

- Open the Activity Monitor located in your /Applications/Utilities folder.

- Type "mysqld" into the search field on the top right.

- Quit every process you find after your search.

Restart MAMP PRO.

 

If MySQL still refuses to start check the log file for error messages.

7.7 My MySQL Server will not start?

The most common problem with MySQL Server not starting is another mysql service running on the same port. To check this 

 

- Quit MAMP PRO.

- Open the Activity Monitor located in your /Applications/Utilities folder.

- Type "mysqld" into the search field on the top right.

- Quit every process you find after your search.

Restart MAMP PRO.

 

If MySQL still refuses to start check the log file for error messages.

8.1 Activating Output Buffering

  1. Start MAMP PRO
  2. Select File -> Edit Template -> PHP 5.x.x php.ini / PHP 5.x.x php.ini
  3. Search this line "output_buffering = Off”
  4. Change "Off" to "On" or to a maximum number of bytes instead (for example "4096")
  5. Save the file
  6. Start Servers

8.1 Activating Output Buffering

  1. Start MAMP PRO
  2. Select File -> Edit Template -> PHP 5.x.x php.ini / PHP 5.x.x php.ini
  3. Search this line "output_buffering = Off”
  4. Change "Off" to "On" or to a maximum number of bytes instead (for example "4096")
  5. Save the file
  6. Start Servers

8.2 Check the Default Storage Engine of MySQL

  1. Open MAMP
  2. Start the servers
  3. Open Terminal.app (/Applications/Utilities)
  4. Enter the following line into the terminal and hit Enter:
    cd /Applications/MAMP/Library/bin
  5. Hit Enter 
    ./mysql --host=localhost -u root -proot
  6. Enter the following line into the MySQL prompt and hit enter:
    USE information_schema;
  7. Enter the following line into the MySQL prompt and hit enter:  
    SELECT * FROM engines;
  8. A table with the Storage Engines of MySQL will show up. Inside the Support column the    Default Storage Engine has the value "DEFAULT".

  9. Enter the following line into the MySQL prompt and hit enter:
    exit;

8.2 Check the Default Storage Engine of MySQL

  1. Open MAMP
  2. Start the servers
  3. Open Terminal.app (/Applications/Utilities)
  4. Enter the following line into the terminal and hit Enter:
    cd /Applications/MAMP/Library/bin
  5. Hit Enter 
    ./mysql --host=localhost -u root -proot
  6. Enter the following line into the MySQL prompt and hit enter:
    USE information_schema;
  7. Enter the following line into the MySQL prompt and hit enter:  
    SELECT * FROM engines;
  8. A table with the Storage Engines of MySQL will show up. Inside the Support column the    Default Storage Engine has the value "DEFAULT".

  9. Enter the following line into the MySQL prompt and hit enter:
    exit;

8.3 Increase the PHP memory limit

  1. Start MAMP PRO
  2. Stop the server if it's running 
  3. Choose Menu > File > Edit Template > PHP 5.x.x php.ini / PHP 5.x.x php.ini
     
  4. The PHP ini file will be opened.
  5. If a dialogue box pops up, read it and confirm with OK
  6. Search (Command-F) for "memory_limit" (without quotes)
  7. You should get the following line:
    memory_limit = 32M ; Maximum amount of memory a script may consume (8M)
  8. Now you can change the default value of 32M. For instance into 64M or even more (like 128M)
  9. Save (Command-S) your changes.
  10. Close (Command-W) the file.
  11. Start the Server.

8.3 Increase the PHP memory limit

  1. Start MAMP PRO
  2. Stop the server if it's running 
  3. Choose Menu > File > Edit Template > PHP 5.x.x php.ini / PHP 5.x.x php.ini
     
  4. The PHP ini file will be opened.
  5. If a dialogue box pops up, read it and confirm with OK
  6. Search (Command-F) for "memory_limit" (without quotes)
  7. You should get the following line:
    memory_limit = 32M ; Maximum amount of memory a script may consume (8M)
  8. Now you can change the default value of 32M. For instance into 64M or even more (like 128M)
  9. Save (Command-S) your changes.
  10. Close (Command-W) the file.
  11. Start the Server.

8.4 Set the MySQL Default Storage Engine

The MySQL server of MAMP PRO uses the Default Storage Engine MyISAM. If you want to change this, you have to change the configuration file of the MySQL server. With this tutorial we want to show you how to manage this. As Default Storage Engine we are using InnoDB.

  1. Start MAMP PRO.
  2. Stop the MAMP PRO server if it is running. 
  3. Select File > Edit Template > MySQL my.cnf
  4. An editor window appears.
  5. If a warning message appears confirm with OK.
  6. Find the section "[mysqld]"
  7. Beneath the last line of this section add this line:
    default-storage-engine = InnoDB
  8. The section "[mysqld]" now looks like this:

  9. Save (Apple + S) all changes made on "my.cnf"
  10. Close the editor window (Apple + W)
  11. Start the MAMP PRO servers.

8.4 Set the MySQL Default Storage Engine

The MySQL server of MAMP PRO uses the Default Storage Engine MyISAM. If you want to change this, you have to change the configuration file of the MySQL server. With this tutorial we want to show you how to manage this. As Default Storage Engine we are using InnoDB.

  1. Start MAMP PRO.
  2. Stop the MAMP PRO server if it is running. 
  3. Select File > Edit Template > MySQL my.cnf
  4. An editor window appears.
  5. If a warning message appears confirm with OK.
  6. Find the section "[mysqld]"
  7. Beneath the last line of this section add this line:
    default-storage-engine = InnoDB
  8. The section "[mysqld]" now looks like this:

  9. Save (Apple + S) all changes made on "my.cnf"
  10. Close the editor window (Apple + W)
  11. Start the MAMP PRO servers.

8.5 Show the Postfix log file With a text editor

Note: If you want to open the Postfix log file with a text editor, you have to make the file visible. 
  1. Open the Terminal.app (Applications/Utilities)
  2. Enter the following and hit Enter
    defaults write com.apple.finder AppleShowAllFiles -boolean true
  3. Restart the Finder by enter the following and hit Enter

    Killall Finder
  4. Open the file /private/var/log/mail.log with your editor.

8.5 Show the Postfix log file With a text editor

Note: If you want to open the Postfix log file with a text editor, you have to make the file visible. 
  1. Open the Terminal.app (Applications/Utilities)
  2. Enter the following and hit Enter
    defaults write com.apple.finder AppleShowAllFiles -boolean true
  3. Restart the Finder by enter the following and hit Enter

    Killall Finder
  4. Open the file /private/var/log/mail.log with your editor.

  1. Open Console.app (Applications/Utilities)
  2. Choose View -> Show Log List
  3. Open the folder "FILES" in the Log List
  4. Open the folder /private/var/log
  5. Click the mail.log entry in the Log List
  6. On the right side of the window you can see the content of the Postfix log file.
  1. Open Console.app (Applications/Utilities)
  2. Choose View -> Show Log List
  3. Open the folder "FILES" in the Log List
  4. Open the folder /private/var/log
  5. Click the mail.log entry in the Log List
  6. On the right side of the window you can see the content of the Postfix log file.

8.7 Show Postfix Logfile Using MySQL command line

  1. Open the Terminal.app (Applications/Utilities)
  2. Enter the following prompt and hit Enter

    tail -f /private/var/log/mail.log
  3. You can now read the Postfix log file within the Terminal. The log file keeps updating as new entries apply.
  4. Press "Ctrl + c" to stop the process.

8.7 Show Postfix Logfile Using MySQL command line

  1. Open the Terminal.app (Applications/Utilities)
  2. Enter the following prompt and hit Enter

    tail -f /private/var/log/mail.log
  3. You can now read the Postfix log file within the Terminal. The log file keeps updating as new entries apply.
  4. Press "Ctrl + c" to stop the process.

8.8 Connect to MySQL from PHP

The following example shows how to connect to a MySQL database using the mysqli() library:

<?php
DEFINE('DB_USERNAME', 'root');
DEFINE('DB_PASSWORD', 'root');
DEFINE('DB_HOST', 'localhost');
DEFINE('DB_DATABASE', 'performance_schema');

$mysqli = new mysqli(DB_HOST, DB_USERNAME, DB_PASSWORD, DB_DATABASE);

if (mysqli_connect_error()) {
die('Connect Error ('.mysqli_connect_errno().') '.mysqli_connect_error());
}

echo 'Connected successfully.';

$mysqli->close();
?>

8.8 Connect to MySQL from PHP

The following example shows how to connect to a MySQL database using the mysqli() library:

<?php
DEFINE('DB_USERNAME', 'root');
DEFINE('DB_PASSWORD', 'root');
DEFINE('DB_HOST', 'localhost');
DEFINE('DB_DATABASE', 'performance_schema');

$mysqli = new mysqli(DB_HOST, DB_USERNAME, DB_PASSWORD, DB_DATABASE);

if (mysqli_connect_error()) {
die('Connect Error ('.mysqli_connect_errno().') '.mysqli_connect_error());
}

echo 'Connected successfully.';

$mysqli->close();
?>

8.9 How do I install PEAR?

Open up a terminal and type the following (replace X.X.X with your version of PHP).

$ echo "export PATH=/Applications/MAMP/bin/php/phpX.X.X/bin:$PATH" >> ~/.profile

Close your terminal session and open up another one. Type the following in the terminal window.

$ which PHP

You should see a path to one of your PHP installations.

Type the following in the terminal window.

$ pear

8.9 How do I install PEAR?

Open up a terminal and type the following (replace X.X.X with your version of PHP).

$ echo "export PATH=/Applications/MAMP/bin/php/phpX.X.X/bin:$PATH" >> ~/.profile

Close your terminal session and open up another one. Type the following in the terminal window.

$ which PHP

You should see a path to one of your PHP installations.

Type the following in the terminal window.

$ pear

8.10 Using MySQL command line

To use the MySQL command line, perform the following steps:

  1. Start MAMP PRO
  2. Start the servers
  3. Open Terminal.app (Applications -> Utilities)
  4. Type in an hit enter.
    cd /Applications/MAMP/Library/bin
  5. Type in and hit enter.
    ./mysql --host=localhost -u root -proot

Now you can use the MySQL command line. For example to show all your databases with

show databases;.

8.10 Using MySQL command line

To use the MySQL command line, perform the following steps:

  1. Start MAMP PRO
  2. Start the servers
  3. Open Terminal.app (Applications -> Utilities)
  4. Type in an hit enter.
    cd /Applications/MAMP/Library/bin
  5. Type in and hit enter.
    ./mysql --host=localhost -u root -proot

Now you can use the MySQL command line. For example to show all your databases with

show databases;.


  1. What is MAMP PRO?
  2. What is MAMP PRO?
  3. Installation
  4. Installation
    1. Installation requirements
    2. Installation requirements
    3. Installing and upgrading MAMP PRO
    4. Installing and upgrading MAMP PRO
    5. Uninstall
    6. Uninstall
  5. First Steps
  6. First Steps
    1. Main GUI Elements
    2. Main GUI Elements
    3. Meaning of Icons
    4. Meaning of Icons
  7. Host and Server Settings
  8. Host and Server Settings
    1. General
    2. General
    3. Hosts
    4. Hosts
      1. General Settings (Host)

      2. General Settings (Host)

      3. Extended (Host)
      4. Extended (Host)
      5. SSL (Host)
      6. SSL (Host)
      7. Extras (Host)
      8. Extras (Host)
        1. Wordpress
        2. Wordpress
        3. Joomla
        4. Joomla
        5. webEdition
        6. webEdition
      9. Modules (Apache)
      10. Modules (Apache)
      11. PHP
      12. PHP
      13. MySQL
      14. MySQL
      15. Dynamic DNS
      16. Dynamic DNS
      17. Postfix
      18. Postfix
    5. Menu
    6. Menu
      1. MAMP PRO
      2. MAMP PRO
      3. File
      4. File
      5. Log
      6. Log
      7. Tools
      8. Tools
    7. FAQ
    8. FAQ
      1. What is MAMP PRO?
      2. What is MAMP PRO?
      3. Are updates free of charge?
      4. Are updates free of charge?
      5. Is MAMP PRO compatible with Mac OS X 10.9 (Mavericks)?
      6. Is MAMP PRO compatible with Mac OS X 10.9 (Mavericks)?
      7. Can I use MAMP at the same time as MAMP PRO?
      8. Can I use MAMP at the same time as MAMP PRO?
      9. Which PHP modules are included?
      10. Which PHP modules are included?
      11. Where do I find my registration number?
      12. Where do I find my registration number?
      13. Is it possible to add an updated version of PHP?
      14. Is it possible to add an updated version of PHP?
      15. Can the port assignment be the same for MAMP and MAMP PRO?
      16. Can the port assignment be the same for MAMP and MAMP PRO?
      17. Can I use MAMP at the same time as MAMP PRO?
      18. Can I use MAMP at the same time as MAMP PRO?
      19. Where should I store my HTML and PHP pages?
      20. Where should I store my HTML and PHP pages?
      21. Is the ImageMagick PHP module included?
      22. Is the ImageMagick PHP module included?
      23. Which Apache modules are included?
      24. Which Apache modules are included?
      25. Is it possible to install MAMP PRO on an external drive?
      26. Is it possible to install MAMP PRO on an external drive?
      27. Will MAMP work if the MAMP folder is not located in the Applications directory?
      28. Will MAMP work if the MAMP folder is not located in the Applications directory?
      29. Are the amount of virtual hosts aliases limited?
      30. Are the amount of virtual hosts aliases limited?
      31. Where can I find the log files?
      32. Where can I find the log files?
      33. Where exactly are the MAMP PRO files created or changed?
      34. Where exactly are the MAMP PRO files created or changed?
    9. Troubleshooting
    10. Troubleshooting
      1. The last time I opened Extras there was a Content Management System that is now not available?
      2. The last time I opened Extras there was a Content Management System that is now not available?
      3. My Content Management System stopped working without any indication of what is wrong?
      4. My Content Management System stopped working without any indication of what is wrong?
      5. I setup up Wordpress and it is asking for a username and password?
      6. I setup up Wordpress and it is asking for a username and password?
      7. My Apache Server will not start?
      8. My Apache Server will not start?
      9. When I type http://localhost in my browser it brings me to Google search?
      10. When I type http://localhost in my browser it brings me to Google search?
      11. Changes to my php.ini file and/or my httpd.conf file are not showing up when I restart MAMP PRO.
      12. Changes to my php.ini file and/or my httpd.conf file are not showing up when I restart MAMP PRO.
      13. My MySQL Server will not start?
      14. My MySQL Server will not start?
    11. How To's
    12. How To's
      1. Activating Output Buffering
      2. Activating Output Buffering
      3. Check the Default Storage Engine of MySQL
      4. Check the Default Storage Engine of MySQL
      5. Increase the PHP memory limit
      6. Increase the PHP memory limit
      7. Set the MySQL Default Storage Engine
      8. Set the MySQL Default Storage Engine
      9. Show the Postfix log file With a text editor
      10. Show the Postfix log file With a text editor
      11. Show the Postfix log file With Console.app (recommended)
      12. Show the Postfix log file With Console.app (recommended)
      13. Show Postfix Logfile Using MySQL command line
      14. Show Postfix Logfile Using MySQL command line
      15. Connect to MySQL from PHP
      16. Connect to MySQL from PHP
      17. How do I install PEAR?
      18. How do I install PEAR?
      19. Using MySQL command line
      20. Using MySQL command line