Superheap

Substack blocks kill-the-newsletter.com and I wanted to just run my own version. Substack has ended RSS feeds and made them into emails. Superheap is the opposite and takes emails and builds an RSS feed just like KTN. There's no utility to this over KTN except that you can run it on whatever domain you like and retain everything.

Installation

1. Run superheap serve --config /path/to/config.json

2. Add a cron that runs superheap generate --config /path/to/config.json every so often

3. Put a STARTTLS-capable MTA (e.g., Postfix) on port 25 and relay to superheap on 127.0.0.1:10025

4. Use stunnel for implicit TLS on 465

5. Subscribe to whatever-email@your.host on Substack

6. Use some means to host the RSS feeds. I use Cloudflare Pages and just create a new deployment every now and then.

Configs

Example configurations:

• configs/postfix-main.cf and configs/postfix-transport: Postfix front-end on :25 that offers STARTTLS and relays to 127.0.0.1:10025.
• configs/stunnel.conf: implicit TLS listener on :465 that forwards to 127.0.0.1:10025 (optional if you want to support SMTPS). An example configuration for superheap is in configs/superheap.json.

License

MIT