redlib-org / redlib

# Redlib
> An alternative private front-end to Reddit, with its origins in Libreddit.
---
**10-second pitch:** Redlib is a private front-end like Invidious but for Reddit. Browse the coldest takes of r/unpopularopinion without being tracked.
- 🚀 Fast: written in Rust for blazing-fast speeds and memory safety
- ☁️ Light: no JavaScript, no ads, no tracking, no bloat
- 🕵 Private: all requests are proxied through the server, including media
- 🔒 Secure: strong Content Security Policy prevents browser requests to Reddit
---
## Table of Contents
1. Redlib
2. Instances
3. About
 - Built with
 - How is it different from other Reddit front ends?
 - Teddit
 - Libreddit
4. Comparison
 - Speed
 - Privacy
 - Reddit
 - Redlib
 - Server
5. Deployment
 - Docker
 - Docker Compose
 - Docker CLI
 - Podman 
 - Quadlets
 - Binary
 - Running as a systemd service
 - Building from source
 - Replit/Heroku/Glitch
 - launchd (macOS)
6. Configuration
 - Instance settings
 - Default user settings
---
# Instances
> [!TIP]
> 🔗 **Want to automatically redirect Reddit links to Redlib? Use LibRedirect or Privacy Redirect!**
An up-to-date table of instances is available in Markdown and machine-readable JSON.
Both files are part of the redlib-instances repository. To contribute your self-hosted instance to the list, see the redlib-instances README.
For information on instance uptime, see the Uptime Robot status page.
---
# About
> [!NOTE]
> Find Redlib on 💬 Matrix, 🐋 Quay.io, :octocat: GitHub, and 🦊 GitLab.
Redlib hopes to provide an easier way to browse Reddit, without the ads, trackers, and bloat. Redlib was inspired by other alternative front-ends to popular services such as Invidious for YouTube, Nitter for Twitter, and Bibliogram for Instagram.
Redlib currently implements most of Reddit's (signed-out) functionalities but still lacks a few features.
## Built with
- Rust - Programming language
- Hyper - HTTP server and client
- Askama - Templating engine
- Rustls - TLS library
## How is it different from other Reddit front ends?
### Teddit
Teddit is another awesome open source project designed to provide an alternative frontend to Reddit. There is no connection between the two, and you're welcome to use whichever one you favor. Competition fosters innovation and Teddit's release has motivated me to build Redlib into an even more polished product.
If you are looking to compare, the biggest differences I have noticed are:
- Redlib is themed around Reddit's redesign whereas Teddit appears to stick much closer to Reddit's old design. This may suit some users better as design is always subjective.
- Redlib is written in Rust for speed and memory safety. It uses Hyper, a speedy and lightweight HTTP server/client implementation.
### Libreddit
While originating as a fork of Libreddit, the name "Redlib" was adopted to avoid legal issues, as Reddit only allows the use of their name if structured as "XYZ For Reddit".
Several technical improvements have also been made, including:
- **OAuth t