tilemill-project / tilemill

TileMill is a modern map design studio
https://tilemill-project.github.io/tilemill/
BSD 3-Clause "New" or "Revised" License
3.12k stars 528 forks source link
mapbox mapnik openstreetmap osm tilemill

Latest Status - June 13, 2021

We are looking for people to get involved! Take a look at some of the current Feature Request Issues, and let us know if you can help.

General Info

TileMill is a modern map design studio powered by Node.js and Mapnik.

Dependencies

Installation

Quick installation instructions for OSX:

git clone https://github.com/tilemill-project/tilemill.git
cd tilemill
nvm install lts/carbon
nvm use v8.15.0
npm install
npm start

Installation Scripts

Scripts have been created that will do most everything for you. They were written for MacOS, but may still be usable for Ubunto and Windows with some modification. (If you are successful with Ubunto and Windows, please post an Issue to let us know!)

Installation Script Instructions

Full Installation instructions can be found in the TileMill Documentation.

Docker

It is also possible to run tilemill as a docker container:

git clone https://github.com/tilemill-project/tilemill.git
cd tilemill
docker-compose up

This will host a docker container which uses the port 20008 and 20009 for tilemill, tilemill is then reachable under http://localhost:20009 . Additionally, a postgis instance is started as well which is reachable under

host=localhost port=5432 user=docker password=docker dbname=gis

Docker hosted volumes are used for the containers, hence if you want to use sqlite dbs you have to interact with those to get the dbs into the docker container.

Build Status, Running Tests, Updating Documentation

See CONTRIBUTING.md