# teddit

> Open-source, self-hosted Reddit front-end that strips JavaScript, ads and tracking, and serves an unofficial RSS and JSON API; no longer actively maintained.

- **Category:** [News Aggregators](https://selfhost.directory/news-aggregators)
- **Licence:** AGPL-3.0
- **Source model:** Open source
- **Latest version:** 1.0.0
- **Author:** teddit
- **Platforms:** Docker Compose, NPM
- **Ports:** 8080 (Default HTTP (non-SSL) port Teddit listens on; also EXPOSEd by the Dockerfile), 8088 (Default SSL port when HTTPS is enabled)
- **Requires:** Redis (optional), Ffmpeg (optional)
- **Tags:** Privacy, Proxy, RSS, Reddit, JSON, No JavaScript, Node.js, Front end, Tracker Blocking

## Docker images

- [`teddit/teddit`](https://hub.docker.com/r/teddit/teddit)

## What 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.

## Should you self-host teddit?

teddit scores **52/100** on selfhost.directory ([how scoring works](https://selfhost.directory/scoring)) and ranks **#3 of 4** in [News Aggregators](https://selfhost.directory/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](https://selfhost.directory/project/lemmy) (75/100, 14 681 stars). It scores higher overall, so compare the two before you pick. [See teddit vs Lemmy side by side.](https://selfhost.directory/compare/lemmy-vs-teddit)

## Features

- Ad-free, JavaScript-free browsing
- Alternative homepage layout
- Backend-proxied requests
- NSFW content gating
- Reddit OAuth or public API — Reddit'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

Requirements: Docker image is available at https://hub.docker.com/r/teddit/teddit

Environment variables:

```
DOMAIN, USE_HELMET, USE_HELMET_HSTS, TRUST_PROXY, REDIS_HOST
```

```docker
version: "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:
```

Note: 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.

### Install teddit with NPM

Requirements: Node.js

1. Install [Node.js](https://nodejs.org).

1. (Optional) Install [redis-server](https://redis.io).

   Highly recommended – it works as a cache for Reddit API calls.

1. (Optional) Install [ffmpeg](https://ffmpeg.org).

   It's needed if you want to support videos.

   ```bash
   # Linux
   apt install redis-server ffmpeg

   # macOS
   brew install redis
   ```

1. Clone and set up the repository.

   ```bash
   git clone https://codeberg.org/teddit/teddit
   cd teddit
   npm install --no-optional
   cp config.js.template config.js # edit the file to suit your environment
   redis-server
   npm start
   ```

Note: Runs at http://localhost:8080. Can also be started from pm2 (pm2 start app.js --name teddit).

## teddit is a self-hosted alternative to

- [Reddit](https://selfhost.directory/alternative-to/reddit)

## teddit alternatives

- [Redlib](https://selfhost.directory/project/redlib): Self-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. (compare: https://selfhost.directory/compare/redlib-vs-teddit)
- [Libreddit](https://selfhost.directory/project/libreddit): Self-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. (compare: https://selfhost.directory/compare/libreddit-vs-teddit)
- [eddrit](https://selfhost.directory/project/eddrit): Self-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. (compare: https://selfhost.directory/compare/eddrit-vs-teddit)
- [quetre](https://selfhost.directory/project/quetre): Self-hosted, open-source alternative front-end for Quora that removes ads, tracking, and bloat with a lightweight, responsive interface, dark mode, and unofficial API. (compare: https://selfhost.directory/compare/quetre-vs-teddit)
- [Tiny Tiny RSS](https://selfhost.directory/project/tiny-tiny-rss): Self-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. (compare: https://selfhost.directory/compare/teddit-vs-tiny-tiny-rss)
- [NodeBB](https://selfhost.directory/project/nodebb): Self-hosted, open-source forum software built on Node.js with Redis, MongoDB, or PostgreSQL, real-time streaming discussions and ActivityPub federation. (compare: https://selfhost.directory/compare/nodebb-vs-teddit)
- [yitter](https://selfhost.directory/project/yitter): yitter is a self-hosted, open-source Twitter frontend in Python for browsing without JavaScript or tracking, using Redis caching and multiple auth tokens. (compare: https://selfhost.directory/compare/teddit-vs-yitter)
- [PieFed](https://selfhost.directory/project/piefed): PieFed is an open-source, self-hosted fediverse forum and link aggregator in Python/Flask with topics, polls, community wikis and first-rate moderation tools. (compare: https://selfhost.directory/compare/piefed-vs-teddit)

## More in News Aggregators

- [voyager](https://selfhost.directory/project/voyager): Voyager 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 Monitor](https://selfhost.directory/project/world-monitor): Self-hosted open-source dashboard streaming 460 news feeds from 761 providers onto a live map with 57 layers, correlating geopolitics, markets, shipping, aviation
- [AIHOT](https://selfhost.directory/project/aihot): Self-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-brief](https://selfhost.directory/project/dailybrief): Self-hosted AI daily news aggregator with 26+ sources, 21 financial tickers with technical indicators, and 6 swappable LLM backends.
- [Klaxon](https://selfhost.directory/project/klaxon): Klaxon 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.
- [Libreddit](https://selfhost.directory/project/libreddit): Self-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.
- [liuli](https://selfhost.directory/project/liuli): Self-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-project](https://selfhost.directory/project/lobsters-rails-project): Open-source, self-hosted Rails app for running your own link-aggregation and discussion community, with tags, invitations, and public moderation logs.
- [Miniflux](https://selfhost.directory/project/miniflux): Self-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](https://selfhost.directory/project/nextcloud-news): 📰 RSS/Atom feed reader
- [PieFed](https://selfhost.directory/project/piefed): PieFed is an open-source, self-hosted fediverse forum and link aggregator in Python/Flask with topics, polls, community wikis and first-rate moderation tools.
- [Readflow](https://selfhost.directory/project/readflow): Self-hosted open-source news reader with offline reading, PWA support, and webhook integrations for Pocket, Wallabag, and RSS feeds.

## Links

- [Homepage](https://codeberg.org/teddit/teddit)
- [teddit/teddit repository](https://codeberg.org/teddit/teddit)
- [Matrix discussion room](https://matrix.to/#/#teddit:matrix.org)
- [teddit wiki (API and self-hosting)](https://codeberg.org/teddit/teddit/wiki)

---
Source: https://selfhost.directory/project/teddit