# NYC Trash Map

NYC Trash Map is a self-hosted other app. Interactive map of New York City trash, recycling, organics, and bulk-item collection schedules by street and day. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/3128/nyc-trash-map

## Description

Interactive map of New York City trash, recycling, organics, and bulk-item collection schedules by street and day.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

47/100 (Fair), based on 3 of 4 factors.
- Maintained: 79 (last commit 12 days ago)
- Popular: 6 (1 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/nyc-trash-map-039xfa81b1d7yk?q=NYC-Trash-Map
- Official website: https://trashmap.nyc

## Common questions

### What ports are needed for the production Docker Compose setup?

The example uses Caddy for HTTPS, so DNS for the domain must point to the host and ports 80 and 443 must reach Caddy.

### Can I deploy it behind an existing reverse proxy?

Yes, run the standalone container in HTTP-only mode and publish the application port 8000 to a host port. Mount a persistent data directory and set DATA_REFRESH_ON_STARTUP=true. Set APP_PUBLIC_URL to the public HTTPS origin without a trailing slash.

### What happens on first startup or first refresh?

The first refresh downloads the source data and builds the map release. The basemap can load before that work is done, and street schedules appear after the release passes validation.

### How do I pin a release instead of always using latest?

The production example always pulls the latest image. Set APP_IMAGE in the .env file when you want to pin a release instead.

### Can I reuse persisted data from an old installation?

The source says to start a new installation with an empty data directory. Incompatible manifests and artifacts are deliberately rejected.

### Do I need to rebuild the image after changing branding variables?

Set the APP_* variables to customize visible branding and the metadata returned in the initial HTML response. Recreate the container after changing them; the image does not need to be rebuilt.

---
Source: Our Local Host (https://ourlocalhost.com/app/3128/nyc-trash-map), the self-hosted and open-source app directory.
