This repository contains the source code for AddressData.net — a website that displays street addresses by city alongside an interactive map.
- Self-hosting: run your own instance; see Installation. A self-hosted instance is functionally identical to the public site.
- Coverage: millions of addresses across 1,500+ cities worldwide.
- Baked Data: no external databases or services are required. A read-only SQLite database containing all addresses is bundled inside the Docker image. See: the “Baked Data” architectural pattern.
-
From the repository root, build and run the container:
docker build -t addressdatanet ./src docker run -it -p 8001:8001 addressdatanet
-
The website can be accessed at http://localhost:8001.
Note: The Docker build can take 20 minutes or more to complete.
Pull requests are accepted.
- Code: MIT.
- Data: Street-address data retrieved using the AddressData tool includes information from OpenStreetMap. © OpenStreetMap contributors. The data is available under the Open Database License (ODbL) v1.0.

