This page assumes you have completed the server setup.
Mobile Access
You can access FreshRSS on mobile devices via browser and via mobile apps.
Access via Browser
The FreshRSS user interface is optimized for both small and large screens. The content will fit nicely on small mobile device screens as well.
Access via Mobile App
FreshRSS supports access from mobile / native apps for Linux, Android, iOS, Windows and macOS, via two distinct APIs: Google Reader API (best), and Fever API (limited features and less efficient).
A list of known apps is available on the FreshRSS GitHub page.
Enable the API in FreshRSS
- Under the section “Authentication”, enable the option “Allow API access (required for mobile apps)”.
- Under the section “Profile”, fill-in the field “API password (e.g., for mobile apps)”.
- Every user must define an API password.
- The reason for an API-specific password is that it may be used in less safe situations than the main password, and does not grant access to as many things.
See the page about the Google Reader compatible API for more details. See the page about the Fever compatible API for more details.
Testing
- Under the section “Profile”, click on the link like
https://rss.example.net/api/
next to the field “API password”. - Click on first link “Check full server configuration”:
- If you get PASS then you are done; all is well.
- If you get Bad Request! or Not Found, then your server probably does not accept slashes
/
that are escaped%2F
, see the next section “Fix server configuration”. - If you receive any other error message, see the next section “Fix server configuration”.
Fix server configuration
- Click on the second link “Check partial server configuration (without
%2F
support)”:- If you get
PASS
, then the problem is indeed that your server does not accept slashes/
that are escaped%2F
.- With Apache, remember the directive
AllowEncodedSlashes On
- Or use a client that does not escape slashes (such as EasyRSS) (
check client list
).
- With Apache, remember the directive
- If you get Service Unavailable!, then check the preceding section “Enable the API in FreshRSS” again.
- With Apache:
- If you get FAIL getallheaders!, the combination of your PHP version and your Web server does not provide access to
getallheaders
- Turn on Apache
mod_setenvif
(often enabled by default), ormod_rewrite
with the following procedure:- Allow
FileInfo
in.htaccess
: see the server setup again. - Enable
mod_rewrite
:- With Debian / Ubuntu:
sudo a2enmod rewrite
- With Debian / Ubuntu:
- Allow
- Turn on Apache
- If you get FAIL getallheaders!, the combination of your PHP version and your Web server does not provide access to
- With nginx:
- If you get Bad Request!, check your server
PATH_INFO
configuration. - If you get File not found!, check your server
fastcgi_split_path_info
.
- If you get Bad Request!, check your server
- If you get FAIL 64-bit or GMP extension!, then your PHP version does not pass the requirement of being 64-bit and/or have PHP GMP extension.
- The easiest is to add the GMP extension. On Debian / Ubuntu:
sudo apt install php-gmp
- The easiest is to add the GMP extension. On Debian / Ubuntu:
- Update and try again from the preceding section “Testing”.
- If you get