An easily installable package for the OpenStreetMap software stack

osm-seed provides a complete, production-ready deployment solution for running your own instance of the OpenStreetMap software stack. Whether you need to manage geospatial datasets that can't be added to the main OpenStreetMap project, or want to leverage the proven OSM infrastructure for your own use case, osm-seed makes it simple to install and manage.

• Why osm-seed?
• Features
• Components
• Quick Start
• Installation
• License & Attribution
• Contributing
• Roadmap

OpenStreetMap runs open source software to manage geospatial data for the entire planet. It has given birth to an entire ecosystem of tools to edit, export, and process spatial data.

Very often, one wants to manage geospatial datasets that cannot be added to the main OpenStreetMap project, either due to license restrictions, or because the data doesn't fit within the scope of the OpenStreetMap project. However, it is still convenient and desirable to use the OpenStreetMap software backend, along with tools like JOSM to edit data, and osmium to export and process data.

The OpenStreetMap software stack has proven itself on a planetary scale, with thousands of hours of development work behind it. This project aims to leverage this power by making it simple to install and manage your own instance of the OpenStreetMap software.

• 🐳 Docker-based: All components are containerized for easy deployment
• ☸️ Kubernetes-ready: Includes Helm charts for production deployments
• 🔄 Complete stack: From database to web interface, tiles to geocoding
• 📦 Modular: Run individual components or the full stack
• 🔧 Configurable: Extensive environment variable configuration
• 📊 Production-tested: Based on the same infrastructure that powers OpenStreetMap

This project provides Docker container definitions for various aspects of the OpenStreetMap software stack, along with configuration scripts to run on a Kubernetes cluster.

• Helm Chart: A complete Helm chart simplifying the process of deploying the entire system onto a Kubernetes cluster. See the chart documentation for details.

# Run just the website
docker compose -f compose/web.yml up

# Run website with data import
docker compose -f compose/web.yml -f compose/populate-apidb.yml up

The recommended way to install osm-seed is to use the published Helm chart. See INSTALL.md for detailed instructions.

For detailed installation instructions, see INSTALL.md.

• Docker and Docker Compose (for local development)
• Kubernetes cluster (for production deployment)
• Helm 3.x (for Kubernetes deployment)

If you plan to use data from the main OpenStreetMap project in your OSM Seed instance, please make sure you're familiar with the ODbL license.

This project is licensed under the MIT License. See LICENSE.txt for details.

osm-seed was originally created by Development Seed, a technology company that builds open source tools for mapping and geospatial data.

• Original Repository: developmentseed/osm-seed
• Copyright: Copyright (c) 2018 Development Seed

This project builds upon and extends the outstanding work done by the Development Seed team. We sincerely appreciate their lasting contributions to the open-source geospatial community.

In January 2026, osm-seed transitioned to its own organization to provide greater flexibility and independence. The project is now maintained by:

• @Rub21
• @batpad
• @geohacker

We continue to build upon the foundation laid by Development Seed while steering the project toward new directions and improvements.

We welcome contributions! If you're interested in contributing, please see our Contributor Guidelines and Code of Conduct.

We are always interested in collaborations and contributions. If this project helps what you're trying to do, we'd love to hear from you!

Eventually, the goal is to include more tools from the OSM ecosystem as part of this stack, and continue to make the process as simple and reproducible as possible. Take a look at our roadmap to see what's planned.

Note: This project explicitly aims to NOT fork OpenStreetMap, but to use the OpenStreetMap codebase as-is, and aims to contribute additions and improvements upstream. It serves as the "package management" layer, allowing one to easily install and manage OSM and related software through a single interface.