selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

oksskolten logo

Self-host oksskolten

v0.5.0

AI-native RSS reader with full-text extraction

BetaOpen SourceAGPL-3.0
Updated4 months ago
LanguageTypescript
Setup difficultyModerate
MobilePWA
ThemeDark mode
Stars
497
Port
3000 (HTTP API and SPA serving)
Requires
Meilisearch
Docker
ghcr.io/babarot/oksskolten
Install with Docker
Home screen (dark mode)Home screen (light mode)Inbox view (dark mode)Inbox view (light mode)Article chat view (dark mode)Article chat view (light mode)Appearance settings (dark mode)Appearance settings (light mode)

What is oksskolten?

Oksskolten is an AI-native RSS reader built for self-hosting. Unlike typical RSS readers that only display feed summaries, this application fetches each article from its original URL, processes the content through Mozilla's Readability library enhanced with hundreds of noise-removal rules, and saves the output as clean Markdown. This full-text foundation enables on-demand AI summarization and translation across three LLM providers, along with a chat interface powered by an MCP server that can search your archive and answer questions. Authentication methods include passwords, Passkeys (WebAuthn), and GitHub OAuth, each configurable independently. The interface offers fourteen color schemes, custom theme import via JSON, nine reading fonts, and functions offline as a PWA with background sync. Deployment relies on Docker Compose: the main application runs in a single container (Node.js 22, Fastify, React 19) alongside Meilisearch for search, with optional RSS Bridge and FlareSolverr services. Pre-built multi-architecture images are available on GHCR. Licensed under AGPL-3.0.

Should you self-host oksskolten?

oksskolten scores 48/100 on selfhost.directory (how scoring works) and ranks #37 of 85 in Feed Reader. It has 497 GitHub stars.

It shipped 8 stable releases in the past year. The latest, v0.5.0, came out on 8 June 2026. New versions land roughly every 2 days.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is AGPL-3.0-licensed and written mostly in Typescript.

Its closest alternative on selfhost.directory is RSS Monster (55/100, 571 stars). It scores higher overall, so compare the two before you pick. See oksskolten vs RSS Monster side by side.

Features

  • Adaptive feed scheduling
  • AI Summarization
  • AI Translation
  • Article Clipping
  • Auto feed discovery
  • Bot-protected site bypass
  • Custom theming
  • Full-Text Extraction
  • Full-Text Search
  • Interactive AI chat
  • MCP Server
  • Multi-Factor Authentication
  • Single-Container Deployment
  • Smart feed fetching

oksskolten README

How to install oksskolten

Install oksskolten with Docker

Docker

docker pull ghcr.io/babarot/oksskolten:latest

Multi-architecture (amd64/arm64) images published to GHCR on every release

How to configure oksskolten

  • AUTH_DISABLEDDisable authentication (requires NODE_ENV=development)

    Disable authentication (requires NODE_ENV=development)

    values: 1

  • CRON_SCHEDULE*/5 * * * *Feed fetch cron schedule

    Feed fetch cron schedule

    values: cron expression

  • DATABASE_URLfile:/data/rss.dbSQLite database URL

    SQLite database URL

    values: file path

  • DATA_DIR./dataData directory path (default: ./data)

    Data directory path (default: ./data)

    values: absolute path

  • FETCH_CONCURRENCY5Article fetch concurrency

    Article fetch concurrency

    values: integer

  • FLARESOLVERR_CONCURRENCY0FlareSolverr concurrency limit

    FlareSolverr concurrency limit

    values: integer

  • FLARESOLVERR_URLhttp://flaresolverr:8191FlareSolverr service URL

    FlareSolverr service URL

    values: URL

  • JWT_SECRETJWT signing secret (auto-generated and stored in DB by default)

    JWT signing secret (auto-generated and stored in DB by default)

  • LOG_LEVELinfoLog level (default: info)

    Log level (default: info)

    values: debug, info, warn, error

  • MEILI_MASTER_KEYMeilisearch master key (required for production)

    Meilisearch master key (required for production)

    values: string

  • MEILI_URLhttp://meilisearch:7700Meilisearch URL

    Meilisearch URL

    values: URL

  • OLLAMA_BASE_URLhttp://host.docker.internal:11434Ollama base URL for local LLM

    Ollama base URL for local LLM

    values: URL

  • PARSE_MAX_THREADS2Maximum parser threads

    Maximum parser threads

    values: integer

  • PORT3000Server port (default: 3000)

    Server port (default: 3000)

    values: port number

  • RSS_BRIDGE_URLhttp://rss-bridge:80RSS Bridge service URL

    RSS Bridge service URL

    values: URL

  • SCORE_RECALC_SCHEDULE*/5 * * * *Cron schedule for score recalculation (default: */5 * * * *)

    Cron schedule for score recalculation (default: */5 * * * *)

    values: Cron expression

  • TUNNEL_TOKENCloudflare Tunnel token (required for production with tunnel)

    Cloudflare Tunnel token (required for production with tunnel)

    values: string

  • TURSO_AUTH_TOKENTurso authentication token (only if using Turso instead of local SQLite)

    Turso authentication token (only if using Turso instead of local SQLite)

    values: string

  • TZUTCTimezone (default: UTC)

    Timezone (default: UTC)

    values: Any valid IANA timezone

  • VLLM_BASE_URLBase URL for vLLM API

    Base URL for vLLM API

    values: URL

oksskolten releases & version history

More in RSS

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…