Start TileMill, choose “Check For Updates…” from the “TileMill” menu, and download any available updates. If TileMill won’t start, you can update by downloading and installing the application again.
Some problems can be fixed by downloading a fresh copy of TileMill and installing it again.
This will reset any customizations you have made to TileMill preferences and will remove any TileMill plugins you have installed.
~/.tilemillinto the “Go to the folder” field and press the “Go” button.
config.jsonfile and the
node_modulesfolder or rename them to back them up.
~/Documentsinto the “Go to the folder” field and press the “Go” button.
MapBox-backupto backup your projects.
MapBoxdirectory should be created. If the application now behaves properly, copy the
MapBox-backupto the newly created
MapBoxfolder to restore your projects.
Ensure you have the latest available version of Safari installed on your Mac by downloading the latest version from Apple.
If TileMill crashes it is possible that some of its internal processes may continue running. While this is a top priority to fix in upcoming releases so that it never occurs, in the meantime users may need to know how to manually stop these “runaway” processes.
A startup error about ports not being available is a common symptom of runaway processes.
To stop them open the “Activity Monitor.app”. This application is located in
After opening Activity Monitor you should see a listing of all running processes in an “Activity Monitor” window. If you do not see this then choose Window > Activity Monitor from the applications top menu.
Click on the “Process Name” column to sort by process name. Click to highlight any processes named “node”, “tilemill”, or “.mbtiles” then click the “Quit Process” button in the upper left and choose “Force Quit”.