Redlib lets you read Reddit without adverts, tracking or an account, through a fast, plain page on your own server. Reddit doesn't like it, though, so expect it to be blocked now and then.
On this page
Good to know before you install
Reddit blocks scrapers, and blocks VPN and datacenter addresses hardest, so Redlib may fail outright behind a VPN and hit rate limits from home.
At a glance#
- What it is
- Reddit Frontend Media
- Where it opens
- Web Interface
On its own port at
http://your-server:port, orredlib.your-domainonce you have a domain - Updates
- Automatic A backup is taken first, and it rolls back if the update fails
- Backups
- Left out Not in the scheduled backups unless you switch it on
- Copies
- As many as you like Run several copies, each with its own data
What it's good for#
Reddit's own site is heavy, nags you to install its app, and follows you around. Redlib shows the same posts and comments in a light, quick page with none of that. You browse subreddits, read threads and search, and Reddit sees your server asking rather than your phone or laptop.
It's for reading. You can't post, vote or comment through it, and there's no Reddit account involved at all.
Using it#
Open it with the Web Interface button and type a subreddit into the search box, or go straight to one by adding it to the address, like /r/unitedkingdom. Links to Reddit work too: swap the reddit.com part of any Reddit link for your Redlib address and the rest stays the same.
The Settings link at the top lets each person choose a theme, the layout, whether to show NSFW posts and more. You can also subscribe to subreddits there to build your own front page. All of that is kept in your browser, not on the server, which is why Redlib has no accounts and nothing to back up. Redlib's settings page can give you a link that restores your settings in another browser.
Settings for everyone#
Three settings apply to everyone who uses your Redlib (they're in its config file; see Settings below):
- Safe Content Only hides every NSFW subreddit and post, with no way for a visitor to turn them back on. Useful if children use it.
- Default Theme is the theme a first-time visitor sees.
- Banner Text puts a line at the top of every page, if you want to say whose server this is.
When it stops working#
Reddit actively tries to stop services like Redlib, and it's hardest on addresses that belong to VPNs and data centres. So:
- At home it usually works, but a busy Redlib can hit Reddit's limits and show errors for a while.
- On a VPS it may be blocked outright, because Reddit recognises the address as a data centre.
- Through a VPN, via Gluetun and the Network Mode setting, you swap your address for the VPN's. That can get round a block on your own address, but VPN addresses are often blocked too. It's worth a try, not a fix.
When Reddit changes how it blocks, the fix has to come from Redlib's developers. Redlib updates automatically, so once they release one it arrives by itself.
Good to know#
- It's public to start with, so anyone who finds the address can use it, and every visitor counts against Reddit's limits on your address. If it's just for you, make it private.
- Search engines are asked not to index it, so it won't turn up in search results.
- It runs locked down: as an unprivileged user, on a read-only filesystem, with no extra permissions.
- More than one copy is possible, for example one with Safe Content Only for the children and one without.
Addresses and ports#
Redlib has one port. LibrePortal picks a free port number for each when you install, so yours will differ from anyone else's. The Config tab's Network section shows them, and the app's Open button uses the right one.
| What it is | Who can reach it | With a domain |
|---|---|---|
| Web Interface | Trusted places only | redlib.your-domain |
Settings#
In its config file#
Redlib's own settings aren't on the Config tab yet. They live in the app's config file, described here so you know they exist. How to change them.
| Setting | What it does | Starts as |
|---|---|---|
NameCFG_REDLIB_DISPLAY_NAME |
What this app is called on your dashboards. Leave empty to use its usual name | Empty |
Show on the LibrePortal DashboardCFG_REDLIB_SHOW_ON_DASHBOARD |
Whether this app gets a shortcut on the front page of the LibrePortal WebUI, separate from any Dashy dashboard Choices: true, false |
true |
Safe Content OnlyCFG_REDLIB_SFW_ONLY |
Hide every NSFW subreddit and post, with no way for a visitor to turn them back on Choices: off, on |
off |
Default ThemeCFG_REDLIB_DEFAULT_THEME |
The theme a first-time visitor sees Choices: system, light, dark, black, dracula, nord, laserwave, violet, gold, rosebox, gruvboxdark, gruvboxlight |
system |
Banner TextCFG_REDLIB_BANNER |
A line shown at the top of every page; leave empty for none | Empty |
Works with#
These are the other apps Redlib knows how to work with. Once it's installed, its page shows the same list with whether each one is connected. How this works.
- Grafana: Shows dashboards for the apps that have one. works with every app
- Prometheus: Collects metrics from the apps that can export them. works with every app
- Uptime Kuma: Watches your apps and shows when one goes down. works with every app
Privacy and security#
Worth knowing Redlib lets you read Reddit without Reddit tracking your device: your server fetches the pages. Reddit does see your server's address.
What leaves this server#
- Your server fetches everything from Reddit, so Reddit sees its address
- Links to removed posts point to a third-party archive when clicked
What LibrePortal turns off#
Nothing needed switching off.
Licence: AGPL-3.0. Audited: 21 October 2026. See the privacy of every app and the Promise.
Sources#
Under the hood#
- It runs this image:
quay.io/redlib/redlib:sha-a4d36e9@sha256:e6647a94d553bf3f7c95c53fc6d9da5785e6c278d9002e99ea32abdb5e3c513a. - It can sit behind Authelia's sign-in once Authelia is installed.
- Its own project and documentation: github.com/redlib-org/redlib
Ports, settings, tools and connections on this page are read from LibrePortal v0.10.97's app catalogue each time the guide is built.