A browser-based tool that turns OpenStreetMap data of any city into a downloadable, themed map poster, with no install needed.
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
Read the installation guide in doc/INSTALL.md
- 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
A client-side web app that turns any searched location into a customizable, high-resolution map poster with themes, layouts and PNG export.
Free, privacy-first offline maps and GPS navigation app for Android and iOS, built on crowd-sourced OpenStreetMap data.
A minimal Python library that draws customized map artwork from OpenStreetMap data using osmnx, matplotlib and shapely.
Python command-line tool that generates minimalist, printable map posters of any city from OpenStreetMap data, with selectable color themes.
Renders every road in a chosen city at once as a map-style visualization, using OpenStreetMap data in the browser.