Getting Started

What is FeedElity?

FeedElity is a personal-first, video-oriented RSS client for following creators across YouTube, Odysee, and PeerTube in one fast, high-density interface. It is self-hosted and privacy-focused.

The app provides a three-column workflow: a creator/source column on the left, a content list in the middle, and a selected content viewer on the right. You can browse the global catalog anonymously, or sign in to manage subscriptions, favorites, playlists, and history.

Built with modern tooling: Solid on the frontend, Hono on the backend, Drizzle ORM with SQLite/libSQL for storage, better-auth for authentication, and Bun as the runtime.

Requirements

Self-Hosting

  • Docker
  • Docker Compose (v2 or later)

Development

  • Bun 1.3 or later
  • Git

Quick Start

The fastest way to get FeedElity running is with Docker Compose.

1. Clone the repository

git clone https://github.com/DimitriGilbert/FeedElity.git
cd FeedElity

2. Create your environment file

cp docker/.env.example .env

Open .env and set the three variables Compose reads: FEEDELITY_PUBLIC_URL (the URL browsers use to reach the app), FEEDELITY_CORS_ORIGIN (allowed origins for the API), and FEEDELITY_AUTH_SECRET, a random string of at least 32 characters (for example openssl rand -base64 48).

3. Build and start the services

docker compose up -d --build

There are no pre-built images: both containers are built from source. On first start the server seeds its database from your local dev snapshot (./local.db) if present, otherwise it starts with an empty database.

4. Open the app

http://localhost:31000

The web app is published on port 31000 and the API server on port 31001. Create an account and start adding sources.

Development Setup

To work on FeedElity locally without Docker, use the Bun runtime.

Install dependencies

bun install

Start the local database

bun run db:local

This starts a local libSQL server on port 8080, backed by the local.db file at the repo root. The server's default dev database points at this file (file:../../local.db in apps/server/.env).

Push the database schema

bun run db:push

Start all dev servers

bun run dev

This starts the web app, API server, and any other dev targets through Turborepo. You can also run individual targets:

bun run dev:web     # Solid web app only
bun run dev:server  # Hono API server only

Type checking and builds

bun run check-types  # TypeScript type check across workspace
bun run build       # Production build

Next Steps

  • Read the Self-Hosting Guide for full deployment options, environment variables, and backup strategies.
  • Add your first source by pasting a YouTube channel URL, Odysee channel URL, or PeerTube video/channel URL.
  • Subscribe to creators, mark favorites, and organize content with playlists.