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.