Folo Self-Hosted — a fork of RSSNext/Folo with a self-hosted backend, Docker deployment, and additional view modes.
- Self-hosted backend (Forage) — Hono API server with Postgres + Redis, replacing the upstream cloud service; includes auto DB migrations on startup
- One-click Docker deployment —
docker compose up -dwith prebuilt images (jhangyu/forage,jhangyu/folo) - Card View & List View — two additional feed view modes with lightbox reader and inline expand
- Adaptive feed crawl — per-subscription refresh interval settings (manual or auto scheduling)
- No OPML import quota — unlimited feed import
- Clone the repo:
git clone https://github.com/jhangyu/Folo.git && cd Folo
- Create your
.envfrom the example:cp apps/forage/.env.example .env
- Edit
.env— fill in the required variables below, then start everything:docker compose up -d
- Open http://localhost:2234
| Variable | Description |
|---|---|
POSTGRES_PASSWORD |
PostgreSQL password |
REDIS_PASSWORD |
Redis password |
BETTER_AUTH_URL |
Public URL of the Forage server (for auth callbacks) |
AUTH_SECRET |
Random secret, min 32 chars (openssl rand -base64 32) |
CORS_ORIGIN |
Allowed origins, comma-separated |
| Variable | Default | Description |
|---|---|---|
WEB_PORT |
2234 |
Folo web UI port |
SERVER_PORT |
3000 |
Forage API port |
VITE_WEB_URL |
http://localhost:2234 |
Public URL of web UI |
Below is the original upstream README from RSSNext/Folo.
As they say, your thoughts are what you read—and we’ve been consuming noisy feeds for too long! Folo organizes content into one timeline, keeping you updated on what matters, noise-free. Share lists, explore collections, and enjoy distraction-free browsing.
Whether for users or professional developers, Folo will be your open information playground. Please be aware that Folo is currently under active development, and feedback is welcome for any issue encountered.
Feel free to try it using the following methods:
| Operating System | Source |
|---|---|
| Any |  |
| iOS |  |
| Android |   |
| macOS |  |
| Windows |  |
| Linux | |
You can also install using the following methods maintained by our community:
- If you are using Arch Linux, you can install the package folo-appimage that is maintained by timochan and grtsinry43.
- If you are using Nix, you can install the package follow that is maintained by iosmanthus.
- If you are using macOS with Homebrew, you can install the cask folo that is maintained by realSunyz.
- If you are using Windows with Scoop, you can install the manifest folo that is maintained by cscnk52.
 |
Join our Discord server to connect with developers, request features, and receive support. |
|---|---|
 |
Follow us on X/Twitter for product updates and to join in on reward activities. |
Important
Star Us, You will receive all release notifications from GitHub without any delay ~
Subscribe to a vast range of feeds and curated lists. Curate your favorites and keep track of what matters most to you.
A smarter and more efficient browsing with AI-powered features like translation, summary, and more.
Because we know content is more than just text. From articles to videos, images to audio — Folo gets it all covered.
This isn’t just another app. Folo is a community — introducing a new era of openness and community-driven experience.
You are welcome to join the open source community to build together, please check our Contributing Guide for more details.
Folo for Windows uses free code signing provided by SignPath.io, a certificate by SignPath Foundation.
Folo for macOS and iOS is signed and notarized by Apple Developer Program.
All released files are verified with GitHub artifact attestations to ensure their provenance and integrity.
Folo is licensed under the GNU Affero General Public License version 3 with the addition of the following special exception:
All content in the icons/mgc directory is copyrighted by https://mgc.mingcute.com/ and cannot be redistributed.