selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
LetterFeed logo

Self-host LetterFeed

0.5.3

Email newsletter to RSS feed converter

BetaOpen SourceMIT
Updated8 hours ago
LanguagePython
Setup difficultyModerate
Stars
207
Port
3000 (frontend web UI)
Docker
ghcr.io/leonmuscoden/letterfeed-frontend
Install with Docker Compose
LetterFeed screenshot 1

What is LetterFeed?

A self-hosted utility for newsletter-to-RSS conversion. It connects to an IMAP mailbox using SSL, periodically fetches new messages from configured senders, processes them, and publishes each as a feed entry. You run it with Docker Compose using separate frontend and backend containers, with SQLite for storage. All settings — mailbox credentials, processing rules, and login info — go in environment variables. The code is MIT-licensed and gets regular updates.

Should you self-host LetterFeed?

LetterFeed scores 41/100 on selfhost.directory (how scoring works) and ranks #63 of 85 in Feed Reader. It has 207 GitHub stars.

It shipped 1 stable release in the past year. The latest, 0.5.3, came out on 8 September 2026.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is MIT-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is RSSHub (85/100, 46 704 stars). It scores higher overall, so compare the two before you pick. See LetterFeed vs RSSHub side by side.

Features

  • Built-in Authentication
  • Configurable email processing
  • Docker Compose Deployment
  • Email newsletter to RSS conversion
  • IMAP over SSL support
  • SQLite Database

LetterFeed README

How to install LetterFeed

Install LetterFeed with Docker Compose

git clone https://github.com/LeonMusCoden/letterfeed.git cd letterfeed cp .env.example .env

Edit .env with your settings

docker compose up -d

Requires Docker and Docker Compose installed

How to configure LetterFeed

  • LETTERFEED_APP_BASE_URLhttp://localhost:3000The base URL of the application

    The base URL of the application

  • LETTERFEED_AUTH_PASSWORDAuthentication password

    Authentication password

  • LETTERFEED_AUTH_USERNAMEAuthentication username

    Authentication username

  • LETTERFEED_AUTO_ADD_NEW_SENDERSfalseAutomatically set up new emails for unknown senders

    Automatically set up new emails for unknown senders

  • LETTERFEED_BACKEND_URLhttp://backend:8000URL of the backend service

    URL of the backend service

  • LETTERFEED_DATABASE_URLsqlite:////data/letterfeed.dbThe database URL

    The database URL

  • LETTERFEED_EMAIL_CHECK_INTERVAL15Interval between checks for new emails (minutes)

    Interval between checks for new emails (minutes)

  • LETTERFEED_IMAP_PASSWORDIMAP password

    IMAP password

  • LETTERFEED_IMAP_SERVERIMAP server address

    IMAP server address

  • LETTERFEED_IMAP_USERNAMEIMAP username

    IMAP username

  • LETTERFEED_MARK_AS_READtrueMark processed emails as read

    Mark processed emails as read

  • LETTERFEED_MOVE_TO_FOLDERFolder to move processed emails

    Folder to move processed emails

  • LETTERFEED_SEARCH_FOLDERINBOXThe folder in which to search for new emails

    The folder in which to search for new emails

  • LETTERFEED_SECRET_KEYSecret key for authentication (generate with openssl rand -hex 32)

    Secret key for authentication (generate with openssl rand -hex 32)

LetterFeed releases & version history

More in Feed Reader

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…