Awesome
Fusion
A lightweight RSS feed aggregator and reader.
Key features include:
- Group, Bookmark, Search, Sniff feeds automatically
- Import/Export OPML file
- Support RSS, Atom, JSON types feed
- Responsive, Light/Dark mode, PWA
- Lightweight, Self-hosted friendly
- Built with Golang and SQLite, Deploy with a single binary
- Pre-built Docker image
- Uses about 80MB of memory
Installation
1. Docker
Choose Docker CLI or Docker Compose examples below:
1.a. Docker CLI
docker run -it -d -p 8080:8080 -v $(pwd)/fusion:/data \
-e PASSWORD="rss123456" \
rook1e404/fusion:latest
1.b. Docker Compose
version: '3'
services:
fusion:
image: rook1e404/fusion:latest
ports:
- '127.0.0.1:8080:8080'
environment:
- PASSWORD=rss123456
restart: "unless-stopped"
volumes:
- ./data:/data
Change ./data
to where you want the files stored. Remember to specify localhost IP unless you want Docker exposing the port though your firewall. Then, in the same directory as this compose.yml
file run docker compose up -d
(or docker-compose up -d
on older versions).
2. Pre-built binary
Download from Releases.
3. Build from source
- Prepare dependencies: Go 1.23+, Node.js 22+.
- Check
scripts.sh
for more details.
For example:
./scripts.sh build
Configuration
Fusion can be configured in many ways:
- System environment variables, such as those set by
export PASSWORD=123abc
. - Create a
.env
file in the same directory as the binary file, and then copy the items you want to modify into it.- NOTE: values in
.env
file can be overwritten by system environment variables.
- NOTE: values in
All configuration items can be found here.
Credits
- Front-end is built with: Sveltekit, shadcn-svelte
- Back-end is built with: Echo, GORM
- Parsing feed with gofeed