# Tiny Tiny RSS

> Web-based news feed reader and aggregator.

- Category: Productivity & Collaboration
- Difficulty: intermediate
- Components: tt-rss, tt-rss-updater, postgresql
- Tags: rss, tt-rss, feed-reader, php, news
- Source: https://docker.recipes/productivity/tt-rss-reader

## Overview

Tiny Tiny RSS (tt-rss) is a self-hosted, web-based RSS/Atom feed reader and aggregator that provides a clean, customizable interface for managing news feeds and articles. Originally developed as an alternative to Google Reader, tt-rss offers features like feed categorization, article filtering, plugin support, and mobile synchronization, making it a popular choice for users seeking privacy-focused news consumption without relying on external services.

This deployment consists of three interconnected services: the main tt-rss web application running on PHP-FPM with static content serving, a dedicated ttrss-updater service that handles background feed updates and maintenance tasks, and a PostgreSQL database for storing feeds, articles, and user data. The updater runs continuously to fetch new content from subscribed feeds, ensuring articles are available when users access the web interface.

This configuration is ideal for privacy-conscious individuals, news enthusiasts, and small teams who want complete control over their RSS consumption without depending on third-party services. The separation of the updater from the main application ensures reliable feed processing while maintaining responsive web performance, making it suitable for both personal use and small organizational deployments.

## Features

- Dual-service architecture with separate web interface and background feed updater for optimal performance
- PostgreSQL backend providing robust data integrity and advanced querying capabilities for feed management
- Plugin ecosystem supporting custom filters, themes, and third-party integrations
- Mobile application support with synchronization API for iOS and Android clients
- Advanced feed filtering with keyword-based rules, regular expressions, and automatic tagging
- Multi-user support with individual preferences, sharing capabilities, and access controls
- OPML import/export functionality for easy migration from other feed readers
- Built-in article archiving and search with full-text indexing through PostgreSQL

## Use cases

- Personal RSS aggregation for tracking blogs, news sites, and technical publications
- Small team knowledge sharing with curated feeds and article recommendations
- News monitoring and research with advanced filtering and categorization
- Privacy-focused alternative to commercial feed readers like Feedly or Inoreader
- Corporate internal news aggregation for industry updates and competitor monitoring
- Academic research with RSS feeds from journals, preprint servers, and conference sites
- Content curation workflow for bloggers and content creators tracking source material

## Prerequisites

- Docker and Docker Compose installed with at least 1GB available RAM for PostgreSQL
- Port 8080 available for the tt-rss web interface
- Environment variables configured: DB_PASSWORD and TTRSS_URL for your domain
- Basic understanding of RSS/Atom feeds and feed URL formats
- Web browser with JavaScript enabled for the full tt-rss interface experience
- SSL certificate and reverse proxy setup recommended for production deployments

## docker-compose.yml

```yaml
services:
  ttrss:
    image: cthulhoo/ttrss-fpm-pgsql-static:latest
    container_name: ttrss
    environment:
      - TTRSS_DB_HOST=db
      - TTRSS_DB_NAME=ttrss
      - TTRSS_DB_USER=ttrss
      - TTRSS_DB_PASS=${DB_PASSWORD}
      - TTRSS_SELF_URL_PATH=${TTRSS_URL}
    volumes:
      - ttrss-data:/var/www/html
    ports:
      - "8080:80"
    depends_on:
      - db
    networks:
      - ttrss-network
    restart: unless-stopped

  ttrss-updater:
    image: cthulhoo/ttrss-fpm-pgsql-static:latest
    container_name: ttrss-updater
    command: /opt/tt-rss/updater.sh
    environment:
      - TTRSS_DB_HOST=db
      - TTRSS_DB_NAME=ttrss
      - TTRSS_DB_USER=ttrss
      - TTRSS_DB_PASS=${DB_PASSWORD}
    volumes:
      - ttrss-data:/var/www/html
    depends_on:
      - ttrss
    networks:
      - ttrss-network
    restart: unless-stopped

  db:
    image: postgres:15-alpine
    container_name: ttrss-db
    environment:
      - POSTGRES_USER=ttrss
      - POSTGRES_PASSWORD=${DB_PASSWORD}
      - POSTGRES_DB=ttrss
    volumes:
      - postgres-data:/var/lib/postgresql/data
    networks:
      - ttrss-network
    restart: unless-stopped

volumes:
  ttrss-data:
  postgres-data:

networks:
  ttrss-network:
    driver: bridge
```

## .env

```bash
# Tiny Tiny RSS
TTRSS_URL=http://localhost:8080/tt-rss
DB_PASSWORD=secure_ttrss_password
```

## Usage notes

- Web UI at http://localhost:8080/tt-rss
- Default login: admin / password
- Change password immediately
- Plugin ecosystem
- Mobile apps available

## Troubleshooting

- tt-rss shows database connection errors: Verify DB_PASSWORD matches between ttrss and db services, ensure database container is running
- Feeds not updating automatically: Check ttrss-updater container logs with 'docker logs ttrss-updater', restart updater service if stuck
- Login fails with admin/password: Database may not be initialized, restart ttrss service and wait for schema creation
- Articles not loading or interface broken: Verify TTRSS_SELF_URL_PATH matches your actual access URL including protocol and port
- PostgreSQL container fails to start: Check postgres-data volume permissions, ensure no port 5432 conflicts with existing PostgreSQL installations
- Plugin installation fails: Ensure ttrss-data volume is properly mounted and writable, check plugin compatibility with tt-rss version

