Repolode
openstreetmap

openstreetmap/openstreetmap-website

The Ruby on Rails application that runs the OpenStreetMap website, its editing API, Browse pages and GPX uploads.

Stars
2,883
Forks
1,104
Open issues
668
Last commit
yesterday

What is it?

This is the Ruby on Rails codebase behind the OpenStreetMap website and its editing API. It covers user accounts, diary entries, user-to-user messaging, the XML and JSON editing API (v0.6), the Browse pages for viewing map data, and GPX trace uploads and browsing.

A complete installation also depends on separate services such as map tile servers and geocoding, which are provided by other software. The default setup points at public services, so developers can run and test the site without operating that infrastructure themselves. The application uses PostgreSQL as its database and has a substantial list of Ruby dependencies.

The project is licensed under GPL-2.0 and accepts pull requests. Bugs are tracked in the GitHub issue tracker, and translations are managed through Translatewiki.

Key features

  • 01Full website with user accounts, diary entries and private messaging
  • 02XML and JSON editing API for OpenStreetMap data
  • 03Browse pages for viewing map data through a web front-end
  • 04GPX trace upload, browsing and API access
  • 05Built on Ruby on Rails with PostgreSQL

Use cases

  • Running a local development instance of the OpenStreetMap website
  • Studying how a large open mapping platform implements its editing API
  • Contributing features or fixes to the OpenStreetMap codebase
  • Hosting a private or regional instance of an OpenStreetMap-style site

Quick start

  1. 1

    Read the installation guide in doc/INSTALL.md

  2. 2

    Clone the repository

Things to know

  • Requires PostgreSQL and a large number of dependencies, so setup is involved.
  • A full installation depends on external map tile and geocoding services.

In collections

Topics

FAQ

What is openstreetmap-website?
The Ruby on Rails application that runs the OpenStreetMap website, its editing API, Browse pages and GPX uploads. This is the Ruby on Rails codebase behind the OpenStreetMap website and its editing API. It covers user accounts, diary entries, user-to-user messaging, the XML and JSON editing API (v0.6), the Browse pages for viewing map data, and GPX trace uploads and browsing.
Is openstreetmap-website free to use? What license does it have?
openstreetmap-website is open source under the GPL-2.0 license. Check the license terms before using it in commercial products.
Is openstreetmap-website still maintained?
Actively maintained. The last commit to openstreetmap-website was on Nov 5, 2026.
What can I use openstreetmap-website for?
Running a local development instance of the OpenStreetMap website Studying how a large open mapping platform implements its editing API Contributing features or fixes to the OpenStreetMap codebase Hosting a private or regional instance of an OpenStreetMap-style site
How do I install openstreetmap-website?
Read the installation guide in doc/INSTALL.md Clone the repository
Where can I get openstreetmap-website?
The source code and installation instructions are on GitHub: https://github.com/openstreetmap/openstreetmap-website

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects