Convert email newsletters into Atom feeds
Go to file
Leandro Facchinetti b0fda31eec 2021-03-18 15:32:40 +00:00
.github/workflows 2021-03-18 11:04:43 +00:00
deployment-example 2021-03-18 14:30:22 +00:00
public 2021-03-14 22:45:49 +00:00
src 2021-03-18 15:32:40 +00:00
.gitignore 2021-03-13 23:47:28 +00:00
CODE_OF_CONDUCT.md . 2020-03-17 21:05:16 -04:00
LICENSE . 2021-01-01 18:46:25 +00:00
README.md 2021-03-18 11:40:36 +00:00
package-lock.json 2021-03-17 15:49:43 +00:00
package.json 2021-03-18 11:20:46 +00:00
tsconfig.json 2021-03-09 22:04:05 +00:00

README.md

Kill the Newsletter!

Convert email newsletters into Atom feeds

Source Package Continuous Integration

Support

Patreon (recurring) · PayPal (one-time)

Watch the Code Review!

Use the Hosted Version

The simplest way to use Kill the Newsletter! is with the hosted version at https://kill-the-newsletter.com.

The service is and will always be free; you dont have to create an account; and I dont collect your data or share it with anyone.

Self-Host

You may run Kill the Newsletter! on your own servers if you wish. This guarantees the utmost privacy, and its also a fun system adminstration project. Kill the Newsletter! strikes a good balance between being relatively easy to self-host and being non-trivial at the same time, because it is a web application as well as an email server.

Test on Your Machine

The best way to start self-hosting is to test Kill the Newsletter! on your machine. You cant really use Kill the Newsletter! if its running on your machine because Kill the Newsletter!s email server must be accessible from the internet to receive email and most likely your internet service provider blocks this kind of connection to prevent spam. Still, this is a good first step to get your feet wet by downloading and running Kill the Newsletter! for the first time.

Download the latest release and give it a try. You may send test emails using curl by creating a file like the following:

email.txt

From: Publisher <publisher@example.com>
To: ru9rmeebswmcy7wx@localhost
Subject: Test email with HTML
Date: Sat, 13 Mar 2021 11:30:40

<p>Some HTML</p>

And then running the following command:

$ curl smtp://localhost:2525 --mail-from publisher@example.com --mail-rcpt ru9rmeebswmcy7wx@localhost --upload-file email.txt

(Remember to change the ru9rmeebswmcy7wx in the example above to the appropriate email address for your Kill the Newsletter! test inbox.)

Pre-Requisites

To install Kill the Newsletter! on your own server youll need:

  1. A domain (for example, kill-the-newsletter.com). I use Namecheap to buy domains.

  2. A DNS server. I use the DNS server that comes with the domain I bought at Namecheap (and they even provide free DNS service for domains bought elsewhere).

  3. A server. I rent a $6/month DigitalOcean droplet created with the following configurations:

    Distributions Ubuntu 20.04 (LTS)
    Plan Share CPU · Regular Intel · $5/mo
    Datacenter region Whatever is closest to you—I use New York 1.
    Additional options IPv6 & Monitoring
    Authentication SSH keys
    Hostname Your domain, for example, kill-the-newsletter.com.
    Backups Enabled (thats what makes the $5/month plan actually cost $6/month)

    I also like to assign the droplet a Floating IP because it allows me to destroy and create a new droplet without having to change the DNS and wait for the DNS propagation to happen.

    This is the cheapest DigitalOcean offering, and yet it has managed Kill the Newsletter!s traffic for years, even when it occasionally receives extra attention, for example, when it makes the front page of HackerNews.


  1. Configure the DNS in Namecheap:

    Type Host Value
    A @ <FLOATING IP>
    CNAME www <YOUR DOMAIN, FOR EXAMPLE, “kill-the-newsletter.com”>
    MX @ <YOUR DOMAIN, FOR EXAMPLE, “kill-the-newsletter.com”>
  2. Configure the deployment on package.json, particularly under the following keys:

    • apps.env.BASE_URL.
    • apps.env.EMAIL_DOMAIN.
    • apps.env.ISSUE_REPORT.
    • deploy.production.host.
    • deploy.production.repo.
  3. Configure Caddy, the reverse proxy, on Caddyfile.

  4. Setup the server:

    $ ssh-add
    $ npm run deploy:setup
    
  5. Migrate the existing feeds (if any):

    $ ssh-add
    $ ssh -A root@<YOUR DOMAIN, FOR EXAMPLE, “kill-the-newsletter.com”>
    root@<YOUR DOMAIN, FOR EXAMPLE, “kill-the-newsletter.com”> $ rsync -av <path-to-previous-feeds> /root/kill-the-newsletter.com/current/static/feeds/
    root@<YOUR DOMAIN, FOR EXAMPLE, “kill-the-newsletter.com”> $ rsync -av <path-to-previous-alternate> /root/kill-the-newsletter.com/current/static/alternate/
    
  6. Push to your fork, which will trigger the GitHub Action that deploys the code and starts the server.

Run Locally

Install Node.js and run:

$ npm install
$ npm run develop

The web server will be running at http://localhost:8000 and the email server at smtp://localhost:2525.

Run Tests

Install Node.js and run:

$ npm install-test

Docker Support (Experimental)

Install Docker and run:

$ docker build -t kill-the-newsletter .
$ docker run kill-the-newsletter

The web server will be running at http://localhost:8000 and the email server at smtp://localhost:2525.

For use in production, start with the example Dockerfile.