Settings > Hosts > General

MAMP PRO - Hosts - General

  • Name
    The server name and port number in combination must be unique within MAMP PRO. Often it’s practical to use a reverse domain naming scheme to easily identify them (e.g. use info.mamp.development instead of The unreversed name may conflict with an outside domain name. 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. The name of a host can be up to 254 characters long.

    To open your new host in your default browser, click on the “Open” button to the right of the host name field. This button is only active when the servers are running. The “Open in” button allows you to open the host’s website in a specific browser.

  • PHP Version
    Here you select which PHP version should be used for the host.

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

    An example: The default version is set to 7.4.5. You have HostA set to PHP version “Default (7.4.5)”, HostB set to “7.3.17” and HostC set to “5.6.40”. If you set the PHP version in the PHP section to “7.0.33”, MAMP PRO will adapt the PHP version of HostA to this version (it is set to always use the standard version). The other 2 hosts will not be changed.

    Setting Your PHP Version in MAMP PRO.

    To show the configuration of the currently selected PHP version click on the arrow button to the right of the select box.

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

    To be able to select a value from this select box you must activate the checkbox “Include Dynamic DNS service to GroupStart” in the area “Dynamic DNS” (Servers & Services) and enter your account data in one of the services offered.

  • IP address
    If this field is left empty or contains an * the web server 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 2 to 65535. In most cases the preset value does not need to be changed. The general settings for the ports can be found here.

  • Web server
    Determine which web server will be used with your host.

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

    MAMP PRO - Hosts - General - Document root

    Note: Do not create document root folders under your “/Applications/MAMP” folder. A better location for your document root folders would be “~/Sites/”. When you do this, your host data is separated from the MAMP PRO application data.

    Important: Please note that there will be problems if you use an alias (symbolic link) as document root that points to “/Applications/MAMP/htdocs” folder. For this reason we strongly advise againt doing this.

    You can change the permissions of the selected document root using the permissions panel. This can be accessed via the menu “Tools -> Open Permissions Panel…”.

    MAMP PRO - Hosts - General - Permissions Panel

  • Extras
    With MAMP PRO Extras you can install a content management system in just a few clicks. Press the “Add…” button to install an Extras package.

    Note: We may add or remove Extras from time to time.

    MAMP PRO - Hosts - General - Extras list

    The Extras panel shows the name of the extra, how many installations are possible per document root, and the PHP version and MySQL compatibility. MAMP PRO offers the following Extras.

    Note: The availability of an Extra will be affected by your hosts PHP version, internet connection, cached Extras and available disk space.

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

    MAMP PRO - Hosts - General - Resolution

    • via /etc/host file (this Mac only)
      The basic mapping mechanism which uses the file “/etc/hosts”.

    • via “MAMP Viewer”
      Enable your host to be viewed on the MAMP Viewer. You can only enable this option if your host name ends in “.local”. If this is not the case and you activate this checkbox, you will be asked whether the name of your host should be changed accordingly.

      MAMP PRO - Hosts - General - Resolution - MAMP Viewer

    • via NAMO
      In order for a MAMP PRO host to be resolved in NAMO, it must be marked in MAMP PRO as a NAMO host.

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

    MAMP PRO - Hosts - General - Aliases

    Note: Using an alias for a WordPress page is not suitable because WordPress stores the original name of the host in the database and generates all links etc. with this name.