MapBox

The TileMill Tools allows you start, stop, and submit jobs to tile rendering instances.

Preparing your AWS account

To use TileMill, you'll need an AWS account with the following services activated:

• EC2
• S3
• SQS

Dependencies

The TileMill client tools require Python. On Mac OSX and Linux computers, Python is installed by default, but on Windows computers it will need to be installed. ActivePython is free and recommended for Windows users.

Mac OS X & Linux

1. Download the TileMill tools source package
2. Open a terminal and find the downloaded files
3. Run sudo python setup.py install in tilemill
4. Run sudo python setup.py install in tilemill/boto

Windows

1. Download the TileMill tools Windows distribution
2. Unzip the file and run tilemill.exe and then boto.exe

Configure the tools

Installation creates two configuration files called .boto and .tilemill. On Mac and Linux, these files are located in your home directory. On Windows systems, the files are located in the following directory:

1. Open the .boto file in your text editor and specify your AWS credentials.
2. Create two buckets on your S3 account. One will be used to store input files and the other will hold the outputted tiles.
3. Open the .tilemill file and specify the names of the input and output buckets that you picked in the previous step. Additionally, specify names for the input and output SQS queues. These will be created automatically.

You're tools are now configured and you're ready to move on!