MAMP PRO For Windows is a configuration application that helps you set up and run the Apache web server and the MySQL database server on your PC. 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.
Note: All screenshots appear with the top menu. In several versions of Windows you must press ALT to make the top menu appear.

2.1 Installation requirements

MAMP PRO is officially supported on Windows 7, Windows 8 ,  Windows 8.1( Windows 8 RT/ARM is not supported ), and Windows 10.

MAMP PRO has two system requirements

  • 1GB  RAM 
  • .NET Framework 4.0

In addition to officially supported versions MAMP PRO will work on any desktop OS beginning with WIndows XP and server OS ( although not officially supported ) from 2003 (Excluding some Starter Editions and some specific OS versions) onward.

 

2.2 Installing and upgrading MAMP PRO

  • Download MAMP PRO from https://www.mamp.info.
  • Double click on the MAMP_MAMP_PRO_3.X.X.setup file in your Downloads folder.
  • The System Installer will guide you through the installation process.
  • Your existing c:\MAMP\htdocs\ folder will be preserved if you are installing over a previous installation.
  • Your existing C:\MAMP\db\mysql\ folder will be preserved if you are installing over a previous installation (used by MAMP).
  • Your existing C:\Users\Public\Documents\Appsolute\MAMPPRO\db\ folder will be preserved if you are installing over a previous installation (used by MAMP PRO).
 

2.3 Uninstall

Use the Windows Uninstaller Utilities to uninstall MAMP PRO.

Note : Do not manually remove the c:\MAMP or c:\MAMPPRO folders. This may break the MAMP/MAMP PRO Uninstaller.

 

 

 

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 C:\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.2 Meaning of Icons

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

Provide more information, including phpInfo().

 

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 PC. 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 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.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 ‘Add’ 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 'Choose ...' 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 'Open' 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.19. You have oneHost set to PHP version “Default (5.5.19)”, anotherHost set to “5.5.19” and yetAnotherHost set to “5.3.23”. If you set the PHP version in the PHP section to 5.4.1, 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 hosts file (this PC only)

The basic mapping mechanism which uses the the file hosts file. On most Windows systems it is located in folder C:\Windows\System32\drivers\etc\.

 

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 PC. 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 PC 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. 

 

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.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. 

 

 

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 Add button on the lower left side of the ‘Extras’ panel. 

 

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.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.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

With Xdebug activated you can open the Open XDClient debugger to enable PHP debugging. By default, XDClient expects debugging information on port 9000 of localhost. 

 

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".  

 

Local access only to MySQL database

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

 

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

  

Path to MySQL log file

Errors occurring at startup or during execution of the MySQL server will be saved in this 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 PC, 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 PC 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 SMTP

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

 

Local SMTP relay port

Fill in port number for local SMTP relay port. This is port on your computer of SMTP server. By default it is 25 and in most cases you should leave it like this.

 

Set domain of outgoing emails:
Fill in outgoing server name for outgoing emails. This could be for instance "smtp.johndoe.com" or "smtp.gmail.com" (without quotes). Ask your provider or system administrator if you are unsure about the server name.

 

Port:
Fill in port of outgoing SMTP server. Ask your provider or system administrator if you are unsure about the port number.

 

Use Authentication

Check this option  if outgoing server name requires  authentication.

 

Username

Add the user name of your mail account.

 

Password

Add the password for your mail account.

 

Authentication

It could be "plain" or SSL. Ask your provider or system administrator if you are unsure if server uses authentication.

 

How to set Google Mail for outgoing email in MAMP PRO

If you already have GMail account you have to first enable SMTP access for your account. To enable this option, head into Gmail's Settings and go to the "Forwarding and POP/IMAP" tab. Refer to GMail help for more information.

MAMP PRO should be set with following settings:

Set domain of outgoing emails: smtp.gmail.com

port: 587

Use authentication: yes

Username: [yourusername]@gmail.com

Password: [yourpassword]

Authentication: SSL

Instead of [yourusername] you should enter your GMail username. Instead of [yourpassword] you should enter your GMail password.

 

5.1 MAMP PRO

 

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 thec:/MAMP/htdocs). If you enter /subDirectory in this field, you will be taken to the c:/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.

 

Keyboard shortcut for MAMP

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

 

Automatically Check For Updates

You will be notified when a new version of MAMP PRO is available

 

Check Now

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

  

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.

Backup…

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

If you want to backup all virtual hosts and databases please select and "Virtual Hosts" and "MySQL Databases" option in Backup window.

 

Then choose location for backup.

 

Backing up virtual host files and databases.

 

 

 

After backup.

 

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.

This option will restore your virtual host files and settings and databases.

Please note: All virtual hosts will be restored to their appsolute file paths. For example, if on your source computer there is host named "host1" that has document root is in C:\temp\hosts\files\host1, on your target computer "host1" document root will be restored on the same location (C:\temp\hosts\files\host1), if that is not available, restore would not be possible.

 

Select source folder with your backup on target computer:

 

Restoring from backup on target computer:

Example of virtual hosts on destination computer after restoring:

 

Settings

 

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, 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 C:\MAMP\htdocs\ ). If you enter /subDirectory in this field, you will be taken to the C:\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.

 

Use systray icon for MAMP PRO

MAMP PRO sys tray icon will going to be started on user login or when MAMP PRO starts.

 

Show template editor warning

MAMP PRO will show warning when template editor is open.

 

Automatically Check For Updates

You will be notified when a new version of MAMP PRO is available

 

Check Now

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

 

Save

Save your current unsaved changes.

Revert

Revert you current unsaved changes.

Exit

Quit MAMP PRO.

5.3 Log

The MAMP servers record events and errors in 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. 

 

Show Hosts File

The hosts file 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.

 

6.1 What is MAMP PRO?

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

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 Windows 10?

Yes, MAMP PRO is indeed compatible with Windows 10 (excluding Windows RT/ARM).

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 ( ) 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 Help > About in MAMP PRO, it is shown there.

Note: press the ALT key in MAMP PRO on some versions of Windows to see the menu.

 

To enter new serial number, open the dialog Help > Enter Serial.

 

Dialog to enter serial number:

 

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

Compiled binaries of the PHP interpreter can be found at https://www.mamp.info/en/downloads/. Drop this downloaded folder into your C:\MAMP\htdocs\bin\php\ directory. Quit and re-start 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.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 C:\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. It can be enabled or disabled inside the php.ini template file. Remove or add the ‘;’ from the following line.

;extension=php_imagick.dll

6.12 Which Apache modules are included?

Apache modules are located in the C:\MAMP\bin\apache\modules\ folder.

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

Yes, but in that case external drive should always be present and with the same drive letter.

6.14 Will MAMP work if the MAMP folder is not located in the c:/ directory?

Yes it can be installed on any drive which is registered in Windows system. But because of simplicity, security and user permissions we always adwise installing on default C:\ drive.

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?

By default installation, you can find your log files in C:\MAMP\logs

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

  • C:\Users\Public\Documents\Appsolute\MAMPPRO\
  • C:\Users\Public\Documents\Appsolute\MAMPPRO\conf\
  • C:\Users\[your username]\AppData\Roaming\Appsolute\MAMPPRO\userdb\

Please just change [your username] to your actual name on computer.

MySQL

  • C:\Users\Public\Documents\Appsolute\MAMPPRO\db\

SMTP

  • C:\MAMP\bin\emailrelay\emailrelay-start.bat

 

6.18 After demo has expired

After demo has expired, database files and all other files from MAMP PRO public folder location:

C:\Users\Public\Documents\Appsolute\MAMPPRO

will be unchanged.

After user registers, it can continue using it from MAMP PRO as normal.

User also has option to copy files from this location to other location.

Setup and uninstall also does not remove files from MAMP PRO public folder location.

Only option to remove files from MAMP PRO is through manual user intervention (by moving or deleting).

 

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.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 Apache Server not starting is another httpd service running on the same port. To check this

  1. Quit MAMP PRO.
  2. Open the Windows Task Manager.
  3. Go to the Processes tab.
  4. Quit every 'httpd' process you find.
  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.

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 Task Manager.

- Go to the Processes tab.

- Quit every 'mysqld'  process you find.

Restart MAMP PRO.

 

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

7.8 PHP7 and Windows 7 / Windows Vista

If Apache does not start when PHP7 is selected, check if you have installed Service Pack 1 on Windows 7. On Windows Vista be sure to have Service Pack 2 installed. If you have installed Service pack after MAMP & MAMP PRO setup, you need to reinstall VC14 runtimes manually again (runtime is found in C:\MAMP\Redist folder); or just reinstall MAMP & MAMP PRO setup if you want it to be applied automatically.

7.9 PHP7 removed functions and callbacks

If you get following error when executing PHP script in PHP7: "Call to undefined function mysql_connect()"

Mysql extension was removed in PHP 7.0.0. Instead, the MySQLi or PDO_MySQL extension should be used.

Alternatives to this function include:

mysqli_connect()

PDO::__construct()

<?php
$con = mysqli_connect('localhost', 'username', 'password', 'database');
?>

7.10 Update or reset MySQL password from command line

If you have accidentally changed MySQL password from outside of MAMP PRO, you can revert back those changes directly from MySQL command line. In this way you can again set MySQL password to be the same as used in MAMP PRO.

To check your current MAMP PRO MySQL username, password and port, open WebStart page from MAMP PRO and look for MySQL parameters on front page.

Note: we assume that MAMP is installed in C:\MAMP\ as your default installation directory,
and that MAMP PRO MySQL is running on port 8889 (default MAMP PRO MySQL port).

Login as administrator in command prompt.
Go to folder:

C:\MAMP\bin\mysql\bin

Execute following command:

mysql -uroot -p -P8889

Enter you current root password.

You should get output similar to this:

Welcome to the MySQL monitor. Commands end with ; or \g.
Your MySQL connection id is 6
Server version: Source distribution

Copyright (c) 2000, 2016, Oracle and/or its affiliates. All rights reserved.

Oracle is a registered trademark of Oracle Corporation and/or its
affiliates. Other names may be trademarks of their respective
owners.

Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.

mysql>

Change to MySQL database, enter following command:

use mysql;

Then enter two following commands (one by one):

SET PASSWORD FOR 'root'@'localhost' = PASSWORD('root');
FLUSH PRIVILEGES;

Please note: expression PASSWORD('root') sets root password to default MAMP PRO root password (root).

Then exit MySQL command window, and try if you can login to MySQL again with new password:

C:\MAMP\bin\mysql\bin>mysql -uroot -p -P8889

7.11 Check active ports and connections on my system

To help in troubleshooting issues regarding starting or stopping servers you can always check 'Active Connections List' section in Summary.
This list will show process name and ports on which those processes are active as Listening, Established, etc.

Go to menu Help->Summary and then scroll to 'Active Connections List' section.
Please note: Just press the ALT key in MAMP PRO on some versions of Windows to see the menu.

 

 

7.12 Update MySQL root password through command line

If you have set MySQL root password outside of MAMP PRO you need to set it again to the one used in MAMP PRO.

You can check you're root password on WebStart page from MAMP PRO.

Note: this example assumes you're using MAMP PRO MySQL on port 8889 (by default).

Login to MySQL instance on command line (use you're current root password):

C:\MAMP\bin\mysql\bin>mysql -u root -p -P8889

Change to MySQL database:

use mysql;

Then enter two following commands (one by one):

SET PASSWORD FOR 'root'@'localhost' = PASSWORD('[root]');
FLUSH PRIVILEGES;

This will set root password to "root" (without quotes).

Note: if you have set password in MAMP PRO to some other password than you have to use that password.

Then exit MySQL command window and try again if you can login with root password:

C:\MAMP\bin\mysql\bin>mysql -u root -p -P8889

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 command prompt (Start and then enter cmd.exe)
  4. Enter the following line into the command prompt and hit Enter:
    CD C:\MAMP\bin\mysql\bin\
  5. Hit Enter 
    mysql --host=localhost -u root -proot -P8889
  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 (Ctrl+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 (Ctrl+S) your changes.
  10. Close 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 InnoDB. 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 MyISAM.

  1. Start MAMP PRO.
  2. Stop the MAMP PRO server if it is running. 
  3. Select File > Edit Template > MySQL my.ini
  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 = MyISAM
  8. The section "[mysqld]" now looks like this:

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

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'); 
DEFINE('DB_PORT', 8889);

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

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

echo 'Connected successfully.';

$mysqli->close();
?>

 

If you use MySQL on port 3306 you can define DB_PORT as:

DEFINE('DB_PORT', 3306);

8.9 How do I install PEAR?

First you need to add PHP version to system path with option on PHP page in MAMP PRO. In command promp you can check if php is available in path by executing "php -v" which should show default php version. If it is not still available in command prompt, restart computer.

Download file go-pear.phar from http://pear.php.net/go-pear.phar and save it in folder C:\MAMP\bin\php\php5.5.0 (if php5.5.0 is your default version).

Open again new command prompt instance and enter following. 

cd C:\MAMP\bin\php\php5.5.0

php go-pear.phar

Installation will then continue.

 

 

 

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 command prompt (Start and then enter cmd.exe)
  4. Type in an hit enter.
    CD C:\MAMP\bin\mysql\bin\
  5. Type in and hit enter.
    mysql --host=localhost -u root -proot -P8889

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

show databases;.

8.10. Show menu in MAMP PRO

Just press the ALT key in MAMP PRO on some versions of Windows to see the menu.

8.11 How do I move from MAMP to MAMP PRO?

Moving from MAMP to MAMP PRO is an easy one-step process. Simply click on the MAMP PRO icon to launch MAMP PRO, and the rest is taken care for you. Once you start up the servers in MAMP PRO your databases are automatically transferred over from the MAMP MySQL installation to the MAMP PRO MySQL installation. Although this process is seamless, it is important to remember your MySQL data is stored in two different locations by MAMP and MAMP PRO. Two separate instances of phpMyAdmin are administering these separate separate sets of data.

Your MAMP PRO installation will inform you when your databases are being transferred.

Your MAMP databases are located in your C:\MAMP\db\mysql folder. When you open up MAMP and start your servers, your phpMyAdmin used by MAMP will point to this MySQL database. This instance of phpMyAdmin is located in c:\MAMP\bin\phpMyAdmin. MAMP will continue to point to these databases even after you have initialised and started using MAMP PRO.

Your MAMP PRO databases are located in your C:\Users\Public\Documents\Appsolute\MAMPPRO\db\ folder. When you open up MAMP PRO and start your servers, your phpMyAdmin used by MAMP PRO will point to this MySQL database. This instance of phpMyAdmin is located in C:\Users\Public\Documents\Appsolute\MAMPPRO\phpmyadmin\

Keep this in mind when you suspect data is missing. You may have inadvertently started MAMP, and made some changes to the wrong MySQL database.

 

Moving back to MAMP from a MAMP PRO Trial

If you have used the MAMP PRO two week free trial and wish to go back to using the free MAMP, you will have to manually move your databases. Copy your database files of MAMP PRO to the MAMP database folder. Stop servers first! Make Backups! Just copy, don't move!

Your MAMP PRO databases are located in C:\Users\Public\Documents\Appsolute\MAMPPRO\db\ folder.

Your MAMP databases are located in C:\MAMP\db\mysql folder.

 

8.12 Uninstall and completely delete MAMP PRO and MAMP

This procedure will delete all Mamp and Mamp Pro files created by installation procedure, all configurations, settings, essential hosts information, serial keys, executables, libraries; so please use it with caution.

Note: This assumes that your Windows OS was installed by default on C:\ drive. If it was not on C:\ drive please adjust paths accordingly.

Procedure is following:

- If you have MAMP PRO icon on desktop, right click on icon and check location of MAMP PRO executable (most probably it is in C:\MAMPPRO\). Write down folder location.
- If MAMP PRO is located in C:\MAMPPRO\, MAMP is located on same folder level (most probably C:\MAMP\). Write down also location of MAMP folder.
- Uninstall MAMP & MAMP PRO by using supplied unistall program. You can find uninstall program in Control Panel Add/Remove applet.
- after uninstalling, delete installation folders for MAMP and MAMP PRO (probably they are C:\MAMP\ and C:\MAMPPRO\)

After deleting all Mamp and Mamp Pro folders go to folder:

C:\Users\Public\Documents\Appsolute\

delete folder 'MAMPPRO'.

Then go to the following folder:

C:\Users\[username]\AppData\Roaming\Appsolute\

also delete folder 'MAMPPRO'.

Note: You should instead of [username] use your local username on computer (try to browse with Windows Explorer).

If private folders are not visible you should open Folder Options from Control Panel:
Control panel->Folder Options->View-> check 'Show hidden files, folders and drives'

8.13. .htaccess file and .htpasswd

On virtual host where you need this functionality, select options FollowSymLinks and Multiviews.


After that, restart servers and try accessing virtual host folder with .htaccess file.

Note: Apache module mod_rewrite should be enabled (it is by default)

Password protect folder in your site.

Create .htaccess file and add to root of your site.

For this example we use virtual host "host1" located in "C:\MAMP\htdocs\host1\" with path to site in "mysite".

AuthUserFile C:\MAMP\htdocs\host1\mysite\.htpasswd
AuthGroupFile /dev/null
AuthName "Please Enter Password"
AuthType Basic
Require valid-user

Create .htpasswd file in the same root folder.

You can use some of the online tools to generate .htpasswd (like http://www.htaccesstools.com/htpasswd-generator-windows/ )

After creation of password, copy the text below into your .htpasswd file.

[your username]:[use your generated password]

Insted of [your username] enter your username.

Insted of [use your generated password] enter your generated password.

Test rewrite

To test rewrite, create .htaccess and copy this text (this will redirect user to index.php in your folder)

RewriteEngine On
RewriteCond %{REQUEST_FILENAME} !-f
RewriteRule ^ index.php [QSA,L]

8.14 Windows http.sys and port 80

If you're using http.sys and you want to use web server on port 80, you can try with binding https.sys to IPV6 address.

Open command line as administrator (right click on Command prompt icon and select 'Run as administrator...')

Then enter following command:

netsh http add iplisten ipaddress=::

Afterwards set in Hosts section in MAMP PRO new virtual host with name "local" (without quotes).

After saving and restarting servers in MAMP PRO, you can connect to WebStart page by opening:

http://local/MAMP

or

http://127.0.0.1/MAMP

(Please also check external link for more information: http://www.mikeplate.com/2011/11/06/stop-http-sys-from-listening-on-port-80-in-windows/)

8.15 PHP from command line

Using PHP from command line could be useful for applications which work outside Apache web server.
For example, if you want to use Composer or you want to work with PHP scripts in console.
In this case you need to use option "Add default version from system path" from PHP page in MAMP PRO.

 

After checking this option you will need to restart computer for changes to take into effect.

You can only use PHP from module handler mode (in fcgi mode this option is disabled).

After setting this option, saving and restarting computer, you can open console (cmd.exe from Start button) and then check php by using this options:

Check php version from command line:
C:\>php.exe -v

Check ini configuration from command line:

C:\>php.exe --ini
Configuration File (php.ini) Path: C:\WINDOWS
Loaded Configuration File: C:\Users\Public\Documents\Appsolute\MAMPPRO\conf\php5.6.8.ini
Scan for additional .ini files in: (none)
Additional .ini files parsed: (none)

Phpinfo from command line:

C:\>php.exe -i

Phpinfo from command line redirected to text file:

C:\>php.exe -i > d:\phpinfo.txt

8.16 Edit Apache web server configuration file

If you want to add your custom placeholders in Apache configuration file you need to use templates.

Saved changes in templates will persist between restarts.

After editing and saving your template, MAMP PRO will always use this template to create configuration files.

To edit Apache web server template, please open menu:

File -> Edit Template -> Apache -> httpd.conf

Please note: press ALT key on some versions of Windows for menu to appear.

 

After opening template for Apache web server, make changes to template in editor.

 


After saving changes, please restart servers for changes to take effect.

 

8.17 Edit PHP version configuration file

If you want to add your custom placeholders in PHP configuration file you need to use templates.

Saved changes in templates will persist between restarts.

After editing and saving your template, MAMP PRO will always use this template to create configuration files for desired PHP version.

To edit PHP desired version template, please open menu:

File -> Edit Template -> PHP -> PHP X.X.ini

Instead of PHP X.X.ini use your desired PHP version (for example PHP 5.6.0.ini)

Please note: press ALT key on some versions of Windows for menu to appear.

 


After opening template for PHP version, make changes to template in editor.

 

 


After saving changes, please restart servers for changes to take effect.

 

8.18 Edit MySQL configuration file

If you want to add your custom placeholders in MySQL configuration file you need to use templates.

Saved changes in templates will persist between restarts.

After editing and saving your template, MAMP PRO will always use this template to create configuration file.

To edit MySQL template, please open menu:

File -> Edit Template -> MySQL mysql.ini

Please note: press ALT key on some versions of Windows for menu to appear.

 

After opening template for MySQL mysql.ini, make changes to template in editor.

 

 

After saving changes, please restart servers for changes to take effect.

 

8.19 Setup xip.io on virtual host

In this example we have created setup for one host (named host-16) for xip.io.

Virtual host 'host-16' has document root which is set to 'C:\MAMP\htdocs\host16':

Please note: you need to set and IP address to actual network interface address. And that same address should be used for xip.io. Then Apache would know on which interface it needs to setup host. In this case it is '192.168.2.102' instead of '*' (default).

In particular case it would probably be some other network interface address (just uncheck and check again xip.io option to get current network interface).


Virtual Hosts : host-16
Name resolution: : Yes
via Xip.io (LAN only) : Yes http://host-16.192.168.2.102.xip.io:8888
SSL : No
IP address: : 192.168.2.102
Port number: : *
Dynamic DNS: : -
PHP version: : 5.6.0
Document root: C:\MAMP\htdocs\host16
Is Network Path : No
Server admin: : -
Directory index: : -
Options for <Directory> Directive: : Indexes Includes ExecCGI

 

 

When checked on Android phone (for testing):

 

 

 

And here is how virtual host is generated in httpd.conf section:

<VirtualHost 192.168.2.102:8888>
ServerName host-16
DocumentRoot "C:\MAMP\htdocs\host16"
<Directory "C:\MAMP\htdocs\host16">
Options Indexes Includes ExecCGI
AllowOverride All
Order allow,deny
Allow from all
</Directory>
</VirtualHost>

Please note that 192.168.2.102 is actual interface on which Apache will serve this virtual host.



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

      2. Extended (Host)
      3. SSL (Host)
      4. Extras (Host)
        1. Wordpress
        2. Joomla
        3. webEdition
    3. Modules (Apache)
    4. PHP
    5. MySQL
    6. Dynamic DNS
    7. SMTP
  5. Menu
    1. MAMP PRO
    2. File
    3. Log
    4. Tools
  6. FAQ
    1. What is MAMP PRO?
    2. Are updates free of charge?
    3. Is MAMP PRO compatible with Windows 10?
    4. Can I use MAMP at the same time as MAMP PRO?
    5. Which PHP modules are included?
    6. Where do I find my registration number?
    7. Is it possible to add an updated version of PHP?
    8. Can the port assignment be the same for MAMP and MAMP PRO?
    9. Can I use MAMP at the same time as MAMP PRO?
    10. Where should I store my HTML and PHP pages?
    11. Is the ImageMagick PHP module included?
    12. Which Apache modules are included?
    13. Is it possible to install MAMP PRO on an external drive?
    14. Will MAMP work if the MAMP folder is not located in the c:/ directory?
    15. Are the amount of virtual hosts aliases limited?
    16. Where can I find the log files?
    17. Where exactly are the MAMP PRO files created or changed?
    18. After demo has expired
  7. Troubleshooting
    1. The last time I opened Extras there was a Content Management System that is now not available?
    2. My Content Management System stopped working without any indication of what is wrong?
    3. I setup up Wordpress and it is asking for a username and password?
    4. My Apache Server will not start?
    5. When I type http://localhost in my browser it brings me to Google search?
    6. Changes to my php.ini file and/or my httpd.conf file are not showing up when I restart MAMP PRO.
    7. My MySQL Server will not start?
    8. PHP7 and Windows 7 / Windows Vista
    9. PHP7 removed functions and callbacks
    10. Update or reset MySQL password from command line
    11. Check active ports and connections on my system
    12. Update MySQL root password through command line
  8. How To's
    1. Activating Output Buffering
    2. Check the Default Storage Engine of MySQL
    3. Increase the PHP memory limit
    4. Set the MySQL Default Storage Engine
    5. Connect to MySQL from PHP
    6. How do I install PEAR?
    7. Using MySQL command line
    8. Show menu in MAMP PRO
    9. How do I move from MAMP to MAMP PRO?
    10. Uninstall and completely delete MAMP PRO and MAMP
    11. .htaccess file and .htpasswd
    12. Windows http.sys and port 80
    13. PHP from command line
    14. Edit Apache web server configuration file
    15. Edit PHP version configuration file
    16. Edit MySQL configuration file
    17. Setup xip.io on virtual host