teddit

teddit.net

A free and open source alternative Reddit front-end focused on privacy. Inspired by the Nitter project.

• No JavaScript or ads
• All requests go through the backend, client never talks to Reddit
• Prevents Reddit from tracking your IP or JavaScript fingerprint
• Unofficial API (RSS & JSON support, no rate limits or Reddit account required)
• Lightweight (teddit frontpage: ~30 HTTP requests with ~270 KB of data downloaded vs. Reddit frontpage: ~190 requests with ~24 MB)
• Self-hostable. Anyone can setup an instance. An instance can either use Reddit's API with or without OAuth (so Reddit API key is not necessarily needed).

Join the teddit discussion room on Matrix: #teddit:matrix.org

XMR: 832ogRwuoSs2JGYg7wJTqshidK7dErgNdfpenQ9dzMghNXQTJRby1xGbqC3gW3GAifRM9E84J91VdMZRjoSJ32nkAZnaCEj

Instances

https://teddit.net - Official instance

Community instances:

Installation

Docker-compose method (production)

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_netnetworks: teddit_net:

Note: This compose is made for a true "production" setup, and is made to be used to have teddit behind a reverse proxy, if you don't want that and prefer to directly access teddit via its port:

• Change ports: - "127.0.0.1:8080:8080" to ports: - "8080:8080"
• Remove DOMAIN=teddit.net, USE_HELMET=true, USE_HELMET_HSTS=true, TRUST_PROXY=true

Docker-compose method (development)

git clone https://codeberg.org/teddit/teddit
cd teddit
docker-compose build
docker-compose up

Teddit should now be running at http://localhost:8080.

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

Environment Variables

The following variables may be set to customize your deployment at runtime.

Manual

1. Install Node.js.

2. (Optional) Install redis-server.

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

3. (Optional) Install ffmpeg.

   It's needed if you want to support videos.

   # Linux
   apt install redis-server ffmpeg
   # macOS
   brew install redis
   

4. Clone and set up the repository.

   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
   

Teddit should now be running at http://localhost:8080.