No description
  • PHP 63.4%
  • HTML 21%
  • JavaScript 10.9%
  • CSS 3%
  • Makefile 1.3%
  • Other 0.4%
Find a file
Ryan Grippeling 4c0b273bfd
All checks were successful
[Workflow] On Documentation Change / techdocs (push) Successful in 44s
[Workflow] On Documentation Change / Generate (push) Successful in 0s
[Workflow] On Documentation Change / Build (Zensical) + sync to Garage web (push) Successful in 37s
[Workflow] On Documentation Change / Deploy (docs site / Garage web) (push) Successful in 0s
feat(docs): publish to own docs-freshrss-application bucket (estate #2)
Repo-scoped Garage key via repo-level TECHDOCS_S3_* (shadows org). The
shared docs-site prefix stops receiving updates; the docs domain routes
/freshrss-application to the new bucket in homelab's phase C cutover.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
2026-08-12 17:41:04 +02:00
.forgejo/workflows feat(docs): publish to own docs-freshrss-application bucket (estate #2) 2026-08-12 17:41:04 +02:00
.github/workflows chore(docs): retire GitHub-side docs workflows — Forgejo publishes to docs.webgrip.dev (ADR-0052) 2026-08-11 11:04:13 +02:00
docs feat(docs): publish to docs.webgrip.dev/freshrss-application/ — estate rollout (ADR-0052) 2026-08-11 11:01:00 +02:00
ops feat: added resource limits 2025-08-26 11:29:57 +02:00
src feat: Initial commit 2025-08-17 03:45:15 +02:00
.editorconfig feat: Initial commit 2025-08-17 03:45:15 +02:00
.env.example feat: Initial commit 2025-08-17 03:45:15 +02:00
.gitignore feat: Initial commit 2025-08-17 03:45:15 +02:00
.releaserc.json feat: Initial commit 2025-08-17 03:45:15 +02:00
age.pubkey feat: Initial commit 2025-08-17 03:45:15 +02:00
AGENTS.md feat: Initial commit 2025-08-17 03:45:15 +02:00
catalog-info.yml feat: Initial commit 2025-08-17 03:45:15 +02:00
CHANGELOG.md chore(release): 1.4.0 [skip ci] 2025-08-26 09:30:50 +00:00
docker-compose.yml fix: fixing extensions 2025-08-19 09:10:04 +02:00
LICENSE fix: added license 2025-08-22 23:58:03 +02:00
Makefile feat: Initial commit 2025-08-17 03:45:15 +02:00
README.md feat: Added a bunch of new extentions 2025-08-19 09:46:11 +02:00

freshrss-application

An experimental playground for running FreshRSS with a PostgreSQL backend. The repository packages the application and database in a single Docker Compose stack and ships the documentation used by the development team.

Setup

  1. Copy .env.example to .env and adjust values if needed.

  2. Start the stack:

    make start
    # or
    docker-compose up -d
    
  3. Open http://localhost:8080 and follow the FreshRSS installation wizard.

Dependencies

  • Docker and Docker Compose
  • GNU Make
  • Optional: mkcert for local HTTPS

Tech Stack

  • FreshRSS selfhosted RSS reader
  • PostgreSQL persistent storage
  • Docker Compose container orchestration
Possible next extensions:

https://framagit.org/nicofrand/xextension-threepanesview https://github.com/tryallthethings/freshvibes?tab=readme-ov-file https://github.com/giventofly/freshrss-comicsinfeed