MAMP PRO (macOS) Documentation

product overview

Search

Menu > Tools

  • Start servers / Stop servers
    Clicking this menu item starts or stops the servers.

  • WebStart
    Clicking this menu item opens the WebStart page in your default browser. This menu item is active only when a web server is running.

  • Reset Server Settings…
    Clicking this menu item will reset the general settings (Ports & Users, Editor, Servers & Services, Languages) to the default settings. Site settings and MAMP PRO preferences are not included in this reset.

  • Apache

    • Restart
      This option allows you to restart the Apache web server individually. This menu item is only active when the Apache web server is running.

    • Force Quit
      If Apache is running but MAMP PRO is unable to detect the correct status, the application may not be able to (re)start or stop the server instances. Calling this function will help MAMP PRO regain control of Apache.

    • Show httpd.conf… / Show httpd-ssl.conf…
      Calling this option will display the Apache configuration file (httpd(-ssl).conf) used for http(s) connections currently used by the running server instances. It is displayed in read-only mode. If you want to make changes, you must edit the template. These menu items are only active when the Apache web server is running.

    • Info… Clicking this menu item opens your default browser and display a page with lots of information about the instance of the Apache web server you are running. This menu item is only active when the Apache web server is running.

    • Status…
      Clicking this menu item opens your default browser and display a page with status information about the instance of the Apache web server you are running. This menu item is only active when the Apache web server is running.

    • Check Configuration
      Click on this menu item to check the Apache configuration files. Click on this menu item to check the Apache configuration files. If an error is found during the check, a dialog box is displayed with details of the error found.

    • Reset Apache Modules…
      Clicking on this menu item resets the selection of Apache modules to the default.

  • Nginx

    • Restart
      This option allows you to restart the Nginx web server individually. This menu item is only active when the Nginx web server is running.

    • Force Quit
      If Nginx is running but MAMP PRO is unable to detect the correct status, the application may not be able to (re)start or stop the server instances. Calling this function will help MAMP PRO to regain control over Nginx.

    • Show nginx.conf…
      Calling this option will display the Nginx configuration file (nginx.conf) connections currently used by the running server instances. It is displayed in read-only mode. If you want to make changes, you must edit the template. This menu item is only active when the Nginx web server is running.

    • Status…
      Clicking this menu item opens your default browser and display a page with status information about the instance of the Nginx web server you are running. This menu item is only active when the Nginx web server is running.

    • Check Configuration
      Click on this menu item to check the Nginx configuration files. Click on this menu item to check the Nginx configuration files. If an error is found during the check, a dialog box is displayed with details of the error found.

    • Reset Modules…
      Clicking on this menu item resets the selection of Ngnix modules to the default state.

  • MySQL

    • Open phpMyAdmin…
      phpMyAdmin is a web-based administration tool written in PHP. It allows you to modify data and perform administrative tasks such as creating new databases. MAMP PRO includes two versions of phpMyAdmin to support the different versions of PHP. The dynamic selection of the phpMyAdmin version is based on the PHP version set on the “localhost” site.

      The source files for these instances of phpMyAdmin can be found in “/Library/Application Support/appsolute/MAMP PRO/phpMyAdmin” and “/Library/Application Support/appsolute/MAMP PRO/phpMyAdmin5”. Additional MySQL users can be created using the User Accounts tab.

    • Open Adminer…
      Adminer is a web-based administration tool written in PHP. It allows you to modify data and perform administrative tasks such as creating new databases.

      The source files for these instances of Adminer can be found in “/Applications/MAMP/bin/adminer”.

    • Open Sequel Ace…
      Sequel Ace (previously Sequel Pro) is a native Mac application. It allows you to create and visualise database schemas in addition to administrative duties. More information on how to connect to MySQL using Sequel Ace can be found in our FAQ section.

      Using Sequel Pro With MAMP PRO

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

    • Restart
      This option allows you to restart the MySQL database server individually. This menu item is only active when the MySQL web server is running.

    • Force Quit
      If MySQL is running but MAMP PRO is unable to detect the correct status, the application may not be able to (re)start or stop the server instances. Calling this function will help MAMP PRO regain control of MySQL. This menu item is only active when the MySQL web server is not running.

    • Show my.cnf…
      Clicking this menu item opens the MySQL configuration file (my.cnf) connections currently used by the running server instances. It is displayed read-only. If you want to make changes, you must edit the template. This menu item is only active when the MySQL web server is running.

    • Check Databases…
      Clicking this menu item opens the dialog box for checking MySQL databases. This function checks the database tables for errors and whether an upgrade is required. This menu item is active only if the MySQL server is running. For more information on this topic, refer to the MySQL manual.

      MAMP PRO - Menu - Tools - MySQL - Check Databases…

    • Repair Databases…
      Clicking this menu item opens the dialog box for repairing MySQL databases. This menu item is active only if the MySQL server is running. For more information on this topic, refer to the MySQL manual.

      MAMP PRO - Menu - Tools - MySQL - Repair Databases…

    • Upgrade Databases…
      Clicking this menu item opens the dialog box for upgrading MySQL databases. This menu item is active only if the MySQL 5.7 server is running. For more information on this topic, refer to the MySQL manual.

      MAMP PRO - Menu - Tools - MySQL - Upgrade Databases…

    • Dump MySQL Databases…
      Clicking this menu item opens the Dump MySQL Databases dialog. This function dumps the contents of all databases to a file on your Desktop, which can be used to transfer the data to other MySQL versions, servers or computers. This menu item is active only when the MySQL server is running.

      MAMP PRO - Menu - Tools - MySQL - Dump Databases…

    • Copy all Databases from v5.7 to v8.0…
      Clicking on this menu item starts the wizard, which helps you to transfer all your MySQL 5.7 databases to MySQL 8.0. This menu item is only active if the MySQL 5.7 server is running.

    • Copy selected Databases from v5.7 to v8.0…
      Clicking on this menu item starts the wizard, which helps you to transfer your selected MySQL 5.7 databases to MySQL 8.0. This menu item is only active if the MySQL 5.7 server is running.

    • Show Databases Files in Finder…
      Clicking on this menu item displays the folder in the Finder in which the MySQL database files of MySQL 5.7 and MySQL 8.0 are stored.

    • Change Password of MySQL VERSION user “root”…
      The “root” user is the administrator of your MySQL database server. The default password for this user is “root”. Clicking this menu item opens a dialog for changing the password. This menu item is active only when the MySQL database server is not running.

      MAMP PRO - Menu - Tools - MySQL - Change Password of MySQL user "root"…

      • New Password
        Enter a new password here.

      • Verify
        Re-enter your password here for verification.

      • Cancel
        Clicking this button will cancel the action and close the dialog.

      • Change
        Click this button to change the password. This button is active only after successful verification.

    • Status…
      Clicking this menu item checks the status of the MySQL database server and displays the result in a dialog box.

      MAMP PRO - Menu - Tools - MySQL - Status…

  • Dynamic DNS

    • Force Quit
      If Dynamic DNS is running but MAMP PRO is unable to determine the correct status, the application may be unable to (re)start or stop the server instances. Calling this function will help MAMP PRO regain control of Dynamic DNS. This menu item is only active when the Dynamic DNS is not running.

  • Redis

    • Restart
      This option allows you to restart Redis individually. This menu item is only active when Redis is running.

    • Force Quit
      If Redis is running but MAMP PRO is not able to detect the correct status, the application may not be able to (re)start or stop the server instances. Calling this function will help MAMP PRO regain control of Redis. This menu item is only active when Redis is not running.

    • Show redis.conf
      Calling this option will display the Redis configuration file (redis.conf) connections currently used by the running server instances. It is displayed in read-only mode. If you want to make changes, you must edit the template.

    • Start interactive Session…
      Clicking this menu item will open the Redis server’s command line interface in the Terminal application on macOS. When this happens for the first time, a dialog box from macOS informs you that MAMP PRO wants to use the Terminal application and asks if you agree. This menu item is only active when Redis is running.

      MAMP PRO - Menu - Tools - Redis - Start interactive Session (question)

    • Flush Cache…
      Clicking this menu item to clear the cache. This menu item is only active when Redis is running.

    • Statistics…
      Clicking this menu item will display live statistics. This menu item is only active when Redis is running.

      MAMP PRO - Menu - Tools - Redis - Statistics

  • Memcached

    • Restart
      This option allows you to restart Memcached individually. This menu item is only active when Memcached is running.

    • Force Quit
      If Memcached is running but MAMP PRO is unable to detect the correct status, the application may not be able to (re)start or stop the server instances. Calling this function will help MAMP PRO regain control of Memcached. This menu item is only active when Memcached is not running.

    • Flush Cache
      Clicking this menu item to clear the cache. This menu item is only active when Memcached is running.

    • Statistics…
      Clicking this menu item will display statistics. This menu item is only active when Memcached is running.

      MAMP PRO - Menu - Tools - Memcached - Statistics

  • MailHog

    • Restart
      This option allows you to restart MailHog individually. This menu item is only active when MailHog is running.

    • Force Quit
      If MailHog is running but MAMP PRO is unable to detect the correct status, the application may not be able to start or stop the server instances. Calling this function will help MAMP PRO regain control of MailHog. This menu item is only active when MailHog is not running.

    • Show mailhog-smtp.json
      This option displays the MailHog configuration file (mailhog-smtp.json). It is displayed in read-only mode. This option is only active if the configuration file exists in the directory “/Library/Application Support/appsolute/MAMP PRO/conf/”. More information about the configuration file can be found here: https://github.com/mailhog/MailHog/blob/master/docs/CONFIG.md

    • Open GUI…
      Clicking this menu item to open the MailHog GUI. Here you can view, delete, download and more.

      MAMP PRO - Menu - Tools - MailHog - MailHog GUI

    • Send a Test Email
      Clicking this menu item will send a test email and open the MailHog web interface (GUI) in your default browser.

      MAMP PRO - Menu - Tools - MailHog - Send a Test Email

  • PHP

    • Open MacGDBp…
      Click on this menu item to open the MacGDBp debugger. This menu item is only enabled if Xdebug is active and MacGDBp is installed. Further information can be found in our FAY entry Using the MacGDBp Debugger.

  • Python

    • Install/upgrade Python Packages…
      Clicking on this menu item opens a dialog where you can install or update Python packages from the Python Packages Index (PyPI). You can specify the name, version and location for the installation.

      MAMP PRO - Menu - Tools - Python - Install/upgrade Python Packages

    • pip Cache Commands…
      Clicking on this menu item opens a dialog where you can check and manage pip’s wheel cache.

      MAMP PRO - Menu - Tools - Python - pip Cache Commands

      The following commands are available:

      • pip cache info: Displays information about the cache.
      • pip cache list: Lists the file names of the packages stored in the cache.
      • pip cache purge: Remove all elements from the cache.
      • pip cache dir: Displays the cache directory.

    • Save List of installed Packages…
      Clicking on this menu item opens a dialog where you can save a list of the installed Python packages in requirements format.

      MAMP PRO - Menu - Tools - Python - Save List of installed Packages

    • Restore Packages from List…
      Clicking on this menu item opens a dialog where you can install Python packages based on a file in the requirements format.

    • Set new Virtual Environment of selected Site…
      Clicking on this menu item to create a virtual environment and assign it to the site.

      You can define the name (corresponding to the directory name) and specify whether installed third-party packages (site-packages) should be added to the Python installation of MAMP PRO. If these two options are not visible to you, you can show them by clicking on the “Options” button.

      MAMP PRO - Menu - Tools - Python - Set new Virtual Environment to selected Site

    • Unset Virtual Environment of selected Site…
      Clicking on this menu item to reset the selection of the “Virtual Env Path”. The virtual environment itself remains unchanged.

    • The Python Packages Index (PyPI)…
      Clicking on this menu item opens the website “The Python Package Index (PyPI)” (https://pypi.org) in your default browser.

  • WordPress

    • Update Root CA certificates of all WordPress sites
      Clicking on this menu item will update the root certification authority certificates of all your WordPress sites in MAMP PRO.

    • Update wp-cli in MAMP Folder
      Clicking on this menu item updates the command line interface for WordPress. Further information on the command line interface for WordPress can be found here.

      If the update was successful, the message “wp-cli has been updated to the latest stable version.” is displayed.

  • SFTP

    • Generate Key Pair from Scratch…
      Clicking on this menu item opens a dialog where you can create an SSH key pair.

      MAMP PRO - Menu - Tools - SFTP - Generate Key Pair from Scratch

    • Generate Private Key from Clipboard…
      Clicking on this menu item opens a dialog with an input field in which you can insert a private key. You can then save it as a .privateKey file.

    • Get Public Key from Private Key…
      Clicking on this menu item opens a dialog where you can extract the public key from a private key.

      MAMP PRO - Menu - Tools - SFTP - Get Public Key from Private Key

    • Servers & Fingerprints…
      Clicking this menu item opens the dialog box with the saved fingerprints of the SFTP connections you are using (see Hosting).

      MAMP PRO - Menu - Tools - SFTP - Servers & Fingerprints

  • Show /etc/hosts File…
    Click this menu item to open the “/etc/hosts” file.

  • Update SSL Certificates for all Sites
    Click on this menu item to renew expired or soon-to-expire SSL certificates for all sites.

  • Update Root CA Certificates
    Clicking on this menu item updates the root certification authority certificates.

  • Clear DNS Cache
    Clicking on this menu item clears the DNS cache of macOS. This is useful when a website’s server has changed its IP address and the new one has not yet found its way into the macOS DNS cache.