Self-host teddit
1.0.0Privacy-focused Reddit front-end with RSS and JSON output
- Ports
- 8080 (Default HTTP (non-SSL) port Teddit listens on; also EXPOSEd by the Dockerfile), 8088 (Default SSL port when HTTPS is enabled)
teddit/tedditWhat is teddit?
teddit is a free, open-source web front-end for Reddit written in Node.js, aimed at readers who do not want to hand their IP address or browser fingerprint to the site. Pages are fetched by the server instead of the visitor's browser, so no JavaScript or ads reach the client, and the project notes that its frontpage is many times smaller than Reddit's own. An unofficial API exposes frontpages, subreddits, user feeds, posts and search results as JSON or RSS, without rate limits or a Reddit login, with extra query flags for full-size thumbnails or raw Reddit-shaped output. Operators can set the theme (including dark and sepia), hide or gate NSFW content, toggle video playback, post flairs, comment sorting and a clean homepage, use Reddit's public API or supply their own OAuth app ID, and cache calls in Redis. Install it with Docker Compose using the published teddit/teddit image alongside Redis behind a reverse proxy, or clone the repo, copy config.js.template to config.js and start it with npm. After Reddit's 2023 API changes the project is not actively maintained any more: pull requests are welcome but merged slowly, and the last tagged release dates from 2021. Teddit hosts no content itself; everything shown comes from Reddit.
teddit alternatives
RedlibSelf-hosted open-source private front-end for Reddit written in Rust: all requests and media are proxied server-side, with no JavaScript, ads, or tracking.CompareRedlib with teddit
LibredditSelf-hosted, open-source private front-end for Reddit written in Rust that proxied all traffic server-side; it stopped working in 2023 and lives on as the Redlib fork.CompareLibreddit with teddit
eddritSelf-hosted, open-source alternative frontend for Reddit with no ads, mobile-friendly design, and RSS support. Runs on Python/Starlette with Valkey for token storage.Compareeddrit with teddit
quetreSelf-hosted, open-source alternative front-end for Quora that removes ads, tracking, and bloat with a lightweight, responsive interface, dark mode, and unofficial API.Comparequetre with teddit
Tiny Tiny RSSSelf-hosted, open-source web RSS/Atom reader and aggregator with folders, OPML, filters, plugins, themes and a JSON API; runs via Docker Compose with PostgreSQL.CompareTiny Tiny RSS with teddit
NodeBBSelf-hosted, open-source forum software built on Node.js with Redis, MongoDB, or PostgreSQL, real-time streaming discussions and ActivityPub federation.CompareNodeBB with teddit
yitteryitter is a self-hosted, open-source Twitter frontend in Python for browsing without JavaScript or tracking, using Redis caching and multiple auth tokens.Compareyitter with teddit- PieFedPieFed is an open-source, self-hosted fediverse forum and link aggregator in Python/Flask with topics, polls, community wikis and first-rate moderation tools.ComparePieFed with teddit
Should you self-host teddit?
teddit scores 52/100 on selfhost.directory (how scoring works) and ranks #3 of 4 in News Aggregators.
There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.
Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is AGPL-3.0-licensed.
Its closest alternative on selfhost.directory is Lemmy (75/100, 14 681 stars). It scores higher overall, so compare the two before you pick. See teddit vs Lemmy side by side.
Features
- Ad-free, JavaScript-free browsing
- Alternative homepage layout
- Backend-proxied requests
- NSFW content gating
- Reddit OAuth or public APIReddit's 2023 API changes broke this upstream access
- RSS Feeds
- Search
- Unofficial JSON API
- User and link flairs
- Video playback
How to install teddit
Install teddit with Docker Compose
DOMAIN, USE_HELMET, USE_HELMET_HSTS, TRUST_PROXY, REDIS_HOSTversion: "3.8"
services:
teddit:
container_name: teddit
image: teddit/teddit:latest
environment:
- DOMAIN=teddit.net
- USE_HELMET=true
- USE_HELMET_HSTS=true
- TRUST_PROXY=true
- REDIS_HOST=teddit-redis
ports:
- "127.0.0.1:8080:8080"
networks:
- teddit_net
healthcheck:
test: ["CMD", "wget" ,"--no-verbose", "--tries=1", "--spider", "http://localhost:8080/about"]
interval: 1m
timeout: 3s
depends_on:
- teddit-redis
teddit-redis:
container_name: teddit-redis
image: redis:6.2.5-alpine
command: redis-server
environment:
- REDIS_REPLICATION_MODE=master
networks:
- teddit_net
networks:
teddit_net:
Production compose meant to run behind a reverse proxy; for direct access change ports to "8080:8080" and drop DOMAIN/USE_HELMET/USE_HELMET_HSTS/TRUST_PROXY. Development builds: git clone, then docker-compose build and docker-compose up.
More in News Aggregators
voyagerVoyager is an open-source, self-hosted mobile-first web client for Lemmy and Piefed, with swipe gestures, multi-account support and native iOS/Android apps.
World MonitorSelf-hosted open-source dashboard streaming 460 news feeds from 761 providers onto a live map with 57 layers, correlating geopolitics, markets, shipping, aviation
AIHOTSelf-hosted, MIT-licensed news-site engine: an LLM filters, scores and clusters RSS, web and social sources into a trending feed plus daily, weekly and monthly digests.
daily-briefSelf-hosted AI daily news aggregator with 26+ sources, 21 financial tickers with technical indicators, and 6 swappable LLM backends.
KlaxonKlaxon is a self-hosted, open-source tool that monitors websites for changes and sends email, Slack, or Discord alerts — built for newsrooms to track newsworthy updates.
LibredditSelf-hosted, open-source private front-end for Reddit written in Rust that proxied all traffic server-side; it stopped working in 2023 and lives on as the Redlib fork.
liuliSelf-hosted, open-source reading pipeline that collects WeChat accounts, novels and blogs, then pushes cleaned articles to DingTalk, WeCom, Telegram, Bark or RSS.
lobsters-rails-projectOpen-source, self-hosted Rails app for running your own link-aggregation and discussion community, with tags, invitations, and public moderation logs.
MinifluxSelf-hosted, open-source RSS/Atom feed reader in Go: one static binary plus PostgreSQL, full-text search, OPML import, and privacy-focused link cleaning.
Nextcloud News📰 RSS/Atom feed reader- PieFedPieFed is an open-source, self-hosted fediverse forum and link aggregator in Python/Flask with topics, polls, community wikis and first-rate moderation tools.
ReadflowSelf-hosted open-source news reader with offline reading, PWA support, and webhook integrations for Pocket, Wallabag, and RSS feeds.
0 comments