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.

Codeberg
teddit logo

Self-host teddit

1.0.0

Privacy-focused Reddit front-end with RSS and JSON output

DiscontinuedOpen SourceAGPL-3.0
Updated5 years ago
Setup difficultyModerate
ThemeDark mode
Ports
8080 (Default HTTP (non-SSL) port Teddit listens on; also EXPOSEd by the Dockerfile), 8088 (Default SSL port when HTTPS is enabled)
Docker
teddit/teddit
Install with Docker Compose

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.

teddit alternatives

All self-hosted alternatives to Reddit →

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

Docker image is available at https://hub.docker.com/r/teddit/teddit
Environment variables
DOMAIN, USE_HELMET, USE_HELMET_HSTS, TRUST_PROXY, REDIS_HOST
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:

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.

How to configure teddit

  • SHOW_UPVOTED_PERCENTAGEShow the upvoted percentage instead of raw vote counts

    values: true, false

  • SHOW_UPVOTESIf true, teddit will show number of upvotes in posts and points in comments

    values: true, false

  • domainDefines URL for Teddit to use (i.e. teddit.domain.com). Defaults to 127.0.0.1
  • use_reddit_oauth*Boolean* If true, "reddit_app_id" must be set with your own Reddit app ID. If false, Teddit uses Reddit's public API. Defaults to false
  • cert_dirDefines location of certificates if using HTTPS (i.e. /home/teddit/le/live/teddit.net). No trailing slash.

More in News Aggregators

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…