Self-host & contribute

Spam Patterns is a pilot tracking recurring spam texts. It is open-source software under the Apache License 2.0. The repository link will appear here once it is public.

Forks and self-hosted copies are not affiliated with the official instance.

Install

One supported path: Docker Compose behind a TLS-terminating reverse proxy. Copy .env.example to .env, set STM_HMAC_KEY to the output of openssl rand -hex 32, then run docker compose up -d. See docs/self-hosting.md.

Your responsibilities as an operator

  • Keep the key secret. Anyone with it can recover sender numbers from stored prefixes.
  • Configure trusted proxies so rate limits see real client addresses.
  • Keep reverse-proxy request-body logging off.
  • Publish your own contacts, retention and takedown practice.
  • Do not add analytics, third-party scripts, or hosted screenshot reading without updating the privacy page first.

Contribute

Good first contributions: area-code data corrections, skeleton grammar test fixtures, and accessibility fixes. Please use synthetic text only, never real messages or numbers.

Security

Report vulnerabilities privately to [email protected]. Best effort, no bounty.

Maintenance

One maintainer, best effort, no service-level promise. Issues are triaged weekly; security and takedown requests come first.

History

Launched November 17, 2026 as Spam Text Map; renamed Spam Patterns on November 19, 2026.