View your stickers
on the map

A self-hosted web application for uploading, viewing, and managing sticker locations worldwide — with automatic GPS extraction from photos.

View on GitHub Helm Install →
Build Release AGPL3 Stars

Features
📍

Interactive Map

Browse all sticker locations on a MapLibre GL powered world map with smooth zoom and pan.

📷

GPS Extraction

Upload a photo and GPS coordinates are automatically read from EXIF metadata — no manual entry needed.

🔐

Role-based Access

Keycloak-backed authentication with four hierarchical roles: viewer, uploader, editor, and admin.

☸️

Kubernetes Ready

Air-gap friendly Helm chart with CNPG database support and embedded Keycloak — no external dependencies.

🗂️

Category Management

Organise stickers into custom categories with admin tooling to manage, merge, and moderate.

🛡️

Self-hosted

AGPL-3.0 licensed. Run it on your own infrastructure — your data stays yours.


Helm Chart
Add the Helm repository
# Add repo
helm repo add stickermap https://watskebart.github.io/stickermap
helm repo update
Minimal install
helm install stickermap stickermap/stickermap \
  --namespace stickermap --create-namespace \
  --set ingress.hostname=stickers.example.com \
  --set keycloak.url=https://auth.example.com \
  --set database.host=postgres.example.com \
  --set database.password=changeme
OCI alternative (GHCR)
helm install stickermap \
  oci://ghcr.io/watskebart/stickermap/stickermap-helm/stickermap \
  --namespace stickermap --create-namespace

Full configuration reference and mandatory values: helm/README.md


Technology Stack
Layer Technology
FrontendAngular 21 (zoneless), TypeScript 5.9, MapLibre GL 5.24
BackendPython 3.14, FastAPI, Pydantic
DatabasePostgreSQL with PostGIS (SRID 4326)
AuthenticationKeycloak, JWT RS256
ContainerPodman / Docker, compose
KubernetesHelm v4