Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A modern map design studio.
JavaScript HTML Objective-C CSS CartoCSS C Other

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.


TileMill is a modern map design studio powered by open source technology.


  • Access datasources on the local filesystem or through Amazon S3
  • Manage map layers with file-based datasources (shapefiles, rasters)
  • Edit carto stylesheets directly in the browser
  • Edit carto stylesheets with a custom editor like vim in Minimal mode
  • Preview map tiles instantly while editing stylesheets
  • Inspect datasource field values and data types
  • Export maps to PNG, PDF and MBTiles formats


  • TileMill client
    • Tested: Chrome 6+, Firefox 3+, IE8+
    • May work: Opera 11
  • TileMill server
    • Tested: Mac OS X 10.6, Ubuntu 10.10
    • At least 2GB memory
    • May work: Older versions, other POSIX-compliant systems

Installation: Mac OS X 10.6

Install Xcode for Mac OS X:

Install Mapnik 2.0 from OS X package:

Install TileMill:

cd TileMill

Start TileMill:


TileMill should now be accessible from a browser at http://localhost:8889.

Installation: Ubuntu 10.10

Install build requirements:

# Mapnik dependencies
sudo apt-get install -y g++ cpp \
libboost-filesystem1.42-dev \
libboost-iostreams1.42-dev libboost-program-options1.42-dev \
libboost-python1.42-dev libboost-regex1.42-dev \
libboost-system1.42-dev libboost-thread1.42-dev \
python-dev libxml2 libxml2-dev \
libfreetype6 libfreetype6-dev \
libjpeg62 libjpeg62-dev \
libltdl7 libltdl-dev \
libpng12-0 libpng12-dev \
libgeotiff-dev libtiff4 libtiff4-dev libtiffxx0c2 \
libcairo2 libcairo2-dev python-cairo python-cairo-dev \
libcairomm-1.0-1 libcairomm-1.0-dev \
ttf-unifont ttf-dejavu ttf-dejavu-core ttf-dejavu-extra \
subversion build-essential python-nose

# Mapnik plugin dependencies
sudo apt-get install libgdal1-dev python-gdal \
postgresql-8.4 postgresql-server-dev-8.4 postgresql-contrib-8.4 postgresql-8.4-postgis \
libsqlite3-0 libsqlite3-dev

# TileMill dependencies
sudo apt-get install libzip1 libzip-dev

Install mapnik from source:

svn checkout mapnik
cd mapnik
python scons/ configure
python scons/
sudo python scons/ install
sudo ldconfig

Install TileMill:

cd TileMill

Start TileMill:


TileMill should now be accessible from a browser at http://localhost:8889.


Optional. Edit settings.js to change server settings including port, files directories, and enabled asset providers.


Something went wrong with that request. Please try again.