Automate MAMP PRO with AppleScript

MAMP PRO supports AppleScript and JavaScript for Automation (JXA). Both scripting languages give you access to the same set of commands. The examples below use AppleScript; see JavaScript for Automation for the JXA equivalents.

Server control

Get server status

tell application "MAMP PRO"    server status "Apache"end tell

Returns one of: stopped, starting, stopping, restarting, running, activatingSystemStart, deactivatingSystemStart, killing, unknown.

Start or stop a single server

tell application "MAMP PRO"    start server "Apache"    start server "MySQL"end tell

tell application "MAMP PRO"    stop server "Apache"end tell

Returns the server name on success, or missing value on error. Common reasons for failure: the server is already running, or the name does not match exactly. Use server status to check the current state before calling start server or stop server.

Start or stop all servers

tell application "MAMP PRO"    start all serversend tell

tell application "MAMP PRO"    stop all serversend tell

Start GroupStart servers

Starts only the servers that have Start with GroupStart enabled in MAMP PRO settings.

tell application "MAMP PRO"    start groupstart serversend tell

Managing sites

List sites

tell application "MAMP PRO"    list all hostsend tell

Returns a list of all site names. Use list active hosts to get only sites that are available when all GroupStart servers are running, or list inactive hosts for the rest.

Add a site

tell application "MAMP PRO"    add host "myproject.local" document root "/Users/me/Sites/myproject"end tell

Optional parameters:

Parameter	Type	Description
`site root`	text	Path to the site root folder
`ssl`	boolean	Enable SSL
`database`	text	Name of a new database to create and map to this site
`install WordPress`	boolean	Install WordPress automatically
`wpAdminName`	text	WordPress admin username
`wpAdminPassword`	text	WordPress admin password
`wpDatabaseName`	text	WordPress database name
`wpDbUserName`	text	WordPress database user
`wpDbPassword`	text	WordPress database password
`wpEmailAddress`	text	WordPress admin email address

Add a site with WordPress

tell application "MAMP PRO"    add host "myblog.local" ¬        document root "/Users/me/Sites/myblog" ¬        install WordPress true ¬        wpAdminName "admin" ¬        wpAdminPassword "secret" ¬        wpDatabaseName "myblog_db" ¬        wpDbUserName "root" ¬        wpDbPassword "root" ¬        wpEmailAddress "me@example.com"end tell

Managing databases

List databases

tell application "MAMP PRO"    list databasesend tell

Returns a list of all MySQL database names. System databases (information_schema, mysql, performance_schema, sys) are omitted.

Add a database

tell application "MAMP PRO"    add database "my_new_database"end tell

Returns true if the database was created, false otherwise.

Snapshots

Create a snapshot of a site

tell application "MAMP PRO"    create snapshot of host "myproject.local"end tell

To save the snapshot to a specific path:

tell application "MAMP PRO"    create snapshot of host "myproject.local" as "/Users/me/Backups/myproject.zip"end tell

Create a snapshot of all sites

tell application "MAMP PRO"    create snapshot of all hostsend tell

JavaScript for Automation (JXA)

All commands are available in JXA as well. Run JXA scripts in Script Editor by selecting JavaScript as the language.

const mampPro = Application("MAMP PRO");
// Get server statusmampPro.serverStatus("Apache");
// Start and stop serversmampPro.startServer("Apache");mampPro.stopAllServers();
// List and add sitesconst sites = mampPro.listAllHosts();mampPro.addHost("myproject.local", { documentRoot: "/Users/me/Sites/myproject" });
// Databasesconst dbs = mampPro.listDatabases();mampPro.addDatabase("my_new_database");
// SnapshotsmampPro.createSnapshotOfHost("myproject.local", { as: "/Users/me/Backups/myproject.zip" });mampPro.createSnapshotOfAllHosts();

On error, JXA commands return null instead of missing value.