Skip to content
Switch branches/tags
This branch is 258 commits ahead, 1834 commits behind hotosm:develop.
Fetch upstream

Latest commit


Failed to load latest commit information.
Latest commit message
Commit time

Tasking Manager

The Tasking Manager is the tool for any organised OpenStreetMap editing and coordination.

The Tasking Manager is Free and Open Source Software, feel free to use the code and set up your own instance. It has been initially designed and built by and for the Humanitarian OpenStreetMap Team, and is nowadays used by many other communities and organizations. The purpose of the tool is to divide up a mapping job into smaller tasks that can be completed rapidly. It shows which areas need to be mapped and which areas need the mapping validated. You can see the tool in action: log into the widely used HOT Tasking Manager and start mapping. For information on how to use the Tasking Manager please have a look on the Tasking Manager user manuals on LearnOSM.


Get the code

git clone


  • Copy the example configuration file to start your own configuration: cp example.env tasking-manager.env.
  • Adjust the tasking-manager.env configuration file to fit your configuration.

Connect with OpenStreetMap

The Tasking Manager uses OpenStreetMap accounts for users to login.

In order to configure this connection you have to go to<Your_OSM_UserName>/oauth_clients/new and fill in the form:

Required OSM OAuth settings

Afterwards copy the consumer key and secret from OpenStreetMap into your configuration file tasking-manager.env, and set the two variables: TM_CONSUMER_KEY and TM_CONSUMER_SECRET.

Run the Tasking Manager

The easiest way to run the Tasking Manager requires Docker and Docker Compose to be installed on your system. Afterwards you'll just need:

  • One command to get everything together and start the Tasking Manager: docker-compose up -d
  • Visit with your browser

For stopping this command do the job: docker-compose stop And you can check the logs with docker-compose logs -f

Alternatively you can review how to install a development setup.

Get involved!



Tasking Manager 3 code, issues, documentation and fun. Please see the Tasking Manager 2 repository for any issues related to the previous version of the Tasking Manager.





No packages published