Fusion on Render

A lightweight, self-hosted RSS reader. Read, group, bookmark, and search feeds in a fast web UI, or use any Fever API client. This repo is the Blueprint. The app runs from the official Fusion image.

What This Template Shows

This repository does not contain the Fusion source. The service pulls the official image from GitHub Container Registry at a pinned version. To upgrade, change the tag in render.yaml and push.

Piece	Role
Fusion	Web UI, feed fetcher, and Fever API in one Go binary.
fusion (Web Service)	The app. Pulls feeds every 30 minutes.
fusion-data (Persistent disk)	The SQLite database at /data/fusion.db.

Architecture

flowchart LR
  user["Browser / Fever client"] --> app["fusion"]
  app --> disk[("fusion-data")]
  app --> feeds["RSS / Atom feeds"]
  ghcr["GHCR: 0x2e/fusion:1.3.0"] --> app

Loading

How It Works

1. Click Deploy to Render. The flow copies this repo into your GitHub account and applies render.yaml.
2. Render creates the disk and generates FUSION_PASSWORD. There is nothing to fill in.
3. Fusion creates its SQLite database on the disk and starts.
4. Copy FUSION_PASSWORD from the service's Environment page and sign in.

Resource	Type	Plan	Notes
fusion	Web, image	Starter	Disk at /data, 1 GB. Health: /api/oidc/enabled. Single instance.

Default region: Oregon.

Quick Start

1. Click Deploy to Render above.
2. Wait until fusion is Live.
3. Copy FUSION_PASSWORD from the Environment page and sign in at the service URL.
4. Add feeds, or import an OPML file from your old reader.

curl -fsS "https://<fusion>.onrender.com/api/oidc/enabled"

Configuration

Variable	Source	Description
FUSION_PASSWORD	Generated	Login password. To change it, edit the value and redeploy.
FUSION_DB_PATH	Blueprint	/data/fusion.db, on the disk.
FUSION_PORT	Blueprint	8080.
FUSION_PULL_INTERVAL	Optional	Seconds between feed refreshes. Default 1800.
FUSION_OIDC_*	Optional	Sign in with SSO. See .env.example.

generateValue runs once, on the first Blueprint apply.

Fever API

Point a Fever client (Reeder, Unread, FeedMe, and others) at https://<fusion>.onrender.com/fever. Use fusion as the username and FUSION_PASSWORD as the password.

Cost

Prices from Render's pricing page.

Resource	Approx. monthly
fusion (Starter)	$7
1 GB disk	$0.25
Total	~$7.25

Fusion used under 10 MB of memory in testing. Starter is the smallest plan that supports a disk.

Troubleshooting

Problem	Solution
Feeds and settings disappear after a deploy	Confirm the disk is mounted at /data and FUSION_DB_PATH is /data/fusion.db.
Sign-in fails	Use the current FUSION_PASSWORD from the Environment page. Too many failed attempts block sign-in for 5 minutes.
Deploy takes about a minute of downtime	Expected. A service with a disk stops the old instance before it starts the new one.

Project Structure

render.yaml       Blueprint. One image-backed web service with a disk.
README.md         This file
LICENSE           Wrapper license
.env.example      Optional extras

Learn More

• Blueprint spec
• Fusion on GitHub

License

MIT for this wrapper. Fusion is also MIT.