summaryrefslogtreecommitdiff
path: root/FAQ.md
blob: 903b24126178f408b774d4f1314e1e288e97d88e (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
Frequently Asked Questions
==========================

#### I'm using lastpass and stuff is broken

Lastpass arbitrarily breaks tt-rss forms preventing various stuff like saving settings from functioning properly.

#### I'm experiencing random failures / UI glitches (error codes 6 & 7) / visibly broken HTML 

Almost every time those are caused by malfunctioning and/or badly written browser extensions. Always try opening tt-rss without browser extensions running (i.e. separate Firefox profile, Chrome incognito mode, etc). This way you will be able to figure out which extension breaks things.

One of the extensions that causes such problems is Lastpass.

#### I have upgraded PHP to 7.2 and now tt-rss complains about mcrypt

Mcrypt extension has been used to encrypt credentials for password-protected feeds via <code>config.php</code> directive <code>FEED_CRYPT_KEY</code>.

If you don't have any feeds with http authentication you can safely set <code>FEED_CRYPT_KEY</code> to an empty string and forget mcrypt ever existed. If you *have* any feeds with stored credentials you will either need to decrypt them first using older PHP version (7.1 or below) by running <code>update.php --decrypt-feeds</code> and then set <code>FEED_CRYPT_KEY</code> to an empty string.

If that is too much effort you will have to enter your login and password again for affected feeds in the Feed Editor. Your other data will not be affected in any way whatsoever.

#### What should I use - MySQL or PostgreSQL?

PostgreSQL should give you much better performance, especially if you tune it a bit.

#### I need an URL I can call to subscribe to feed to integrate with some third party browser extension/application.

<code>SELF\_URL\_PATH/public.php?op=subscribe&feed\_url=%s</code>

SELF\_URL\_PATH = http://your.ttrss.server/tt-rss/

#### I need to get the number of unread articles in the simplest way.

<code>SELF\_URL\_PATH/backend.php?op=getUnread&login=LOGIN</code>

No password required. In single user mode, use “admin” for login.

#### Feeds stop updating for users who rarely login

See this thread: https://tt-rss.org/oldforum/viewtopic.php?f=1&t=2909&p=23459#p17145

#### I have used the update daemon before, but switched away from it. However, the UI keeps nagging me about the daemon not running or not updating feeds or whatever.

Find and delete daemon lock file in <code>LOCK\_DIRECTORY</code>.
Usually, it’s <code>lock/update\_daemon.lock</code>. You can also remove
<code>update\_daemon.stamp</code>.

#### I have questions about article purging / I don't think purging works.

In short, you may and will see articles with date older than the cutoff
for purging. Here’s why:

1. Starred articles are not purged.
2. Purging is done based on article import date internal to tt-rss which
could be different from the date specified in the original feed (e.g.
article has date 01-01-1970, but it was imported today).
3. When tt-rss sees articles still exist in the feed it bumps the import
date because otherwise the articles will get purged and reimported
periodically causing annoyingly reappearing duplicates. This is mostly
relevant for rarely updated feeds.
4. Purging is performed when the feed is updated hence disabled updates
= no purging.

Please see these forum threads for more information:

-   http://tt-rss.org/oldforum/viewtopic.php?f=1&t=792
-   http://tt-rss.org/oldforum/viewtopic.php?f=9&t=560&p=2649&hilit=delete\#p2649

You can see article import date if you mouse over displayed date in
tt-rss web UI.

Related question:

#### I like to manually archive or delete articles and I get duplicates. Why?

Because the articles are still in the feed and get imported again.

#### Using Firefox, “OPML Import window” always visible in Preferences

Apparently it’s some addon or a browser setting problem, using clean
profile helps.

#### Tasker client doesn't work

Read this thread: https://tt-rss.org/oldforum/viewtopic.php?f=16&t=3876

#### Schema upgrade fails on MySQL 5.7 (and newer)

Error message: <code>Invalid default value for 'last_updated'</code>

See this thread/post for instructions: https://tt-rss.org/oldforum/viewtopic.php?f=1&t=3871&p=22884#p22884

#### I have HTTP authentication enabled and get “Your access level is insufficient to run this script” error on login

The problem is that if you have auth\_remote enabled in config.php
tt-rss tries to automatically log you in as the user specified by the
server using HTTP authentication, which may not have administrative
privileges. You will need to either temporarily disable auth\_remote
(replace it with auth\_internal in config.php), temporarily disable HTTP
authentication, or give yourself administrative permissions using the
SQL client:

```sql
    update ttrss_users set access_level = 10 where login = 'you';
```

#### I'm having performance problems, why is tt-rss so slow?

Most likely you don’t have enough hardware for your requested amount of
feeds. Switch up to a faster VDS tier or use something else.