summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
-rw-r--r--FAQ.md42
1 files changed, 7 insertions, 35 deletions
diff --git a/FAQ.md b/FAQ.md
index 1f5a026..0f73a55 100644
--- a/FAQ.md
+++ b/FAQ.md
@@ -28,19 +28,19 @@ This sets your password back to default (``password``) and disables OTP.
### 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.
+The problem is that if you have `auth_remote` enabled in `PLUGINS` 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 authenticati on, or give yourself administrative permissions using SQL client:
+The easiest way is simply updating database using CLI (`php ./update.php --update-schema`). Docker setup does this on startup.
+
+Alternatively, you can either temporarily disable `auth_remote` (replace it with `auth_internal`), temporarily disable HTTP authentication, or give yourself administrative permissions using SQL:
```sql
update ttrss_users set access_level = 10 where login = 'you';
```
--------------------
-
### UI is missing CSS or is otherwise visibly broken
-- Try opening tt-rss using a clean browser profile or an incognito window (a different browser would also work)
+- Try opening tt-rss using safe mode, clean browser profile, or an incognito window (a different browser would also work)
- Unless you're using SSL, try a different network connection in case your ISP is MITMing you
- Some values of ``Content-Security-Policy`` header may break tt-rss, if you have this header set in your httpd config, try disabling it temporarily
- Check for any files in ``(tt-rss)/themes`` not known to Git (especially ``default.php`` or ``default.css`` - formerly default CSS themes for tt-rss, now removed), try temporarily removing all third party themes from ``themes.local``
@@ -71,19 +71,7 @@ body.ttrss_main .cdm .content img, body.ttrss_main .cdm .content video {
`90vh` means "90% of viewport height". This works on Chromium and derivatives, you can use `90%` for Firefox.
--------------------
-
-### What should I use - MySQL or PostgreSQL?
-
-tt-rss is developed with PostgreSQL in mind, MySQL support is an afterthought.
-
-If possible, consider using PostgreSQL for tt-rss. MySQL is supported but some minor features may be exclusive to Postgres and you're going to see worse performance (because InnoDB is slow).
-
-#### MySQL/MariaDB is complaining about SQL errors in ``counters.php``
-
-<https://community.tt-rss.org/t/troubleshoot-problems-updating-to-last-version-c0f689a58f/3344/7?u=fox>
-
-### I want to migrate my data but I can't use a database dump
+### I want to migrate to a different database
One common use case for this is moving from MySQL to PostgreSQL.
@@ -92,23 +80,9 @@ migrate your tt-rss settings and filters.
If you want to migrate your articles, use this plugin: <https://git.tt-rss.org/fox/ttrss-data-migration/wiki>
-### 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://srv.tt-rss.org/oldforum/viewtopic.php@f=1&t=3871&p=22884.html#p22884>
-
--------------------
-
### Feeds stop updating for users who rarely login
-This is controlled by `DAEMON_UPDATE_LOGIN_LIMIT` tunable, declared in [functions.php](https://git.tt-rss.org/fox/tt-rss/src/branch/master/include/functions.php#L61).
-
-You can override (or disable) it through `config.php` (or a `config.d` snippet if using [Compose setup](https://git.tt-rss.org/fox/ttrss-docker-compose)):
-
-```php
-define('DAEMON_UPDATE_LOGIN_LIMIT', 0);
-```
+This is controlled by a global configuration setting. You can override (or disable) it through environment or `config.php` by setting `TTRSS_DAEMON_UPDATE_LOGIN_LIMIT` to `0`.
Note that this also effectively disables purging of articles stored for inactive users.
@@ -148,8 +122,6 @@ See also: [ArchivedFeed](ArchivedFeed)
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 need an URL I can call to subscribe to feed to integrate with some third party browser extension/application.
<code>https://example.com/tt-rss/public.php?op=bookmarklets\-\-subscribe&feed\_url=%s</code>