MAMP PRO (macOS) Documentation

Create a new custom host

Choose this host type if your project requires either a database or if you want to copy files from a template directory. Of course, both options are possible together.

1. Click the “+” button below the list of hosts and go to the “Advanced” section. In the following dialog, select the host type “Custom”.

   

2. Confirm your selection by clicking on the “Continue” button.

3. The next step is to enter the name of your new host. In this example we choose the name “my-host”.

4. As “Document root” we first create the new directory “my-host” and then select it.

   Note: Do not create document root folders under your “Applications/MAMP” folder. A better location for your document root folders would be “~/Sites/”. This will keep your host data separate from the MAMP PRO application data.

5. If you want a database to be added automatically when the new host is created, select the “Add a database” checkbox. The new database will be immediately linked with the new host.


   

6. If you want certain files and directories to be copied to the document root when the new host is created, select the “Copy a template folder” check box. You can select the appropriate template folder in the next steps.


   

7. If you want your new site to be accessible over https, select the SSL checkbox.

Note that this checkbox is automatically checked (and read-only) if you specify a name ending in “.dev” because this is a top-level domain and the publisher has specified that only secure connections over https are allowed for security reasons, so browsers will automatically redirect from http to https. For more information about this top-level domain, see Wikipedia.

1. Confirm your selection by clicking on the “Continue” button.

2. Enter a name for the new database. You can also create a new database user who will have access to the new database. This is optional.

   

3. Confirm your selection by clicking on the “Continue” button.

4. The next step is to select the directory whose contents will be copied to the document root of the new host.

   

5. Confirm your selection by clicking on the “Create Host” button.

6. Finally, you will be reminded to click the “Save” button and restart the servers. Confirm by clicking the OK button.


   

7. Save the settings for your new host by clicking the “Save” button at the bottom right. The servers will then need to be restarted. Confirm this by clicking the “Yes” button in the corresponding dialog box.

   

8. To open your new host in your default browser, click on the “Open” button to the right of the host name field.