[![](https://images.microbadger.com/badges/image/xoxys/ttrss.svg)](https://microbadger.com/images/xoxys/ttrss "Get your own image badge on microbadger.com")
TT-RSS is an open source web-based news feed (RSS/Atom) reader and aggregator, designed to allow you to read news from any location, while feeling as close to a real desktop application as possible.
## Usage
Here are some example snippets to help you get started creating a container.
### Docker
```Shell
docker create \
--name=ttrss \
-p 80:80 \
xoxys/ttrss
```
### Docker Compose
Compatible with docker-compose v2 schemas.
```Yaml
---
version: '2'
services:
ttrss:
image: xoxys/ttrss:latest
ports:
- "80:80"
depends_on:
- db
db:
image: postgres
environment:
POSTGRES_USER: postgres
POSTGRES_PASSWORD: secure
POSTGRES_DB: ttrss
volumes:
- postgres_data:/var/lib/postgresql/data
volumes:
postgres_data:
driver: local
```
## Environment variables
### TT-RSS
```Shell
TTRSS_DB_TYPE=pgsql
TTRSS_DB_HOST=db
TTRSS_DB_USER=postgres
TTRSS_DB_NAME=ttrss
TTRSS_DB_PASS=secure
TTRSS_DB_PORT=5432
TTRSS_SELF_URL_PATH=http://localhost/
TTRSS_SINGLE_USER_MODE=false
TTRSS_SIMPLE_UPDATE_MODE=false
TTRSS_PHP_EXECUTABLE=/usr/bin/php
TTRSS_AUTH_AUTO_CREATE=true
TTRSS_AUTH_AUTO_LOGIN=true
TTRSS_FORCE_ARTICLE_PURGE=0
TTRSS_SPHINX_SERVER=localhost:9312
TTRSS_SPHINX_INDEX=ttrss, delta
TTRSS_ENABLE_REGISTRATION=false
TTRSS_REG_NOTIFY_ADDRESS=
TTRSS_REG_MAX_USERS=10;
TTRSS_SESSION_COOKIE_LIFETIME=86400
TTRSS_SMTP_FROM_NAME=Tiny Tiny RSS
TTRSS_SMTP_FROM_NAME=
TTRSS_DIGEST_SUBJECT=[tt-rss] New headlines for last 24 hours