Fusion

A lightweight RSS reader.

 

Features

• Fast reading workflow: unread tracking, bookmarks, search, and Google Reader-style keyboard shortcuts
• Feed management: RSS/Atom parsing, feed auto-discovery, and group organization
• Responsive web UI with PWA support
• Self-hosting friendly: single binary or Docker deployment
• Built-in i18n: English, Chinese, German, French, Spanish, Russian, Portuguese, Swedish
• No AI features by design: focused, distraction-free RSS reading

Quick Start (Docker)

latest is the latest release.

main is the latest development build.

docker run -it -d -p 8080:8080 \
  -v $(pwd)/fusion:/data \
  -e FUSION_PASSWORD="fusion" \
  ghcr.io/0x2e/fusion:latest

Open http://localhost:8080.

Docker Compose example:

version: "3"
services:
  fusion:
    image: ghcr.io/0x2e/fusion:latest
    ports:
      - "127.0.0.1:8080:8080"
    environment:
      - FUSION_PASSWORD=fusion
    restart: unless-stopped
    volumes:
      - ./data:/data

Other Installation Options

• Pre-built binary: download from Releases
• Build from source: see Contributing
• One-click deployment:
  • Deploy on Fly.io
  • Deploy on Railway (community maintained)

Configuration

All config keys are documented in .env.example.

Common keys:

• FUSION_DB_PATH (default fusion.db)
• FUSION_PASSWORD (required unless FUSION_ALLOW_EMPTY_PASSWORD=true)
• FUSION_PORT (default 8080)
• FUSION_PULL_INTERVAL, FUSION_PULL_TIMEOUT, FUSION_PULL_CONCURRENCY
• FUSION_CORS_ALLOWED_ORIGINS, FUSION_TRUSTED_PROXIES
• FUSION_OIDC_* for optional SSO

Legacy env names (DB, PASSWORD, PORT) are still accepted for backward compatibility.

Documentation

• API contract (OpenAPI): docs/openapi.yaml
• Backend design: docs/backend-design.md
• Frontend design: docs/frontend-design.md
• Legacy schema reference (kept for migration work): docs/old-database-schema.md

Development

• Requirements: Go 1.25+, Node.js 24+, pnpm
• Helpful commands are in scripts.sh
• Frontend i18n key check: cd frontend && npm run check:i18n

Example:

./scripts.sh build

Contributing

Contributions are welcome. Please read Contributing Guidelines before opening a PR.

Credits

• Feed parsing powered by gofeed