This will delete the page "InstallationNotes"
. Please be certain.
Before you begin, you’ll need to verify the following:
After you have gone through the above list, you can proceed to the installation.
git clone https://tt-rss.org/git/tt-rss.git tt-rss
Alternatively, you can clone the repository on your local machine and upload files to the server using FTP or any other means available to you.
Verify that you can open http://yoursite/tt-rss/install/
Proceed with the installation using the easy installer. It will ask
your database credentials and a full URL on which tt-rss will be
accessed, for example http://yoursite/tt-rss/install/
.
It is required that the URL is an externally accessible one (if any),
don’t use localhost
there, it will break PUSH support. If
you are deploying tt-rss on LAN, you can disregard this requirement.
Easy installer will generate config.php
for you,
after you have entered your database credentials and initialized tt-rss
database. You will need to either copy text from the installer and paste
it into config.php
on the server, or, if possible, the
installer will be able to do it for you automatically.
It is suggested that you read through config.php
to see
if you need to enable additional functionality or change default
configuration values.
After finishing with the installer, open your Tiny Tiny RSS
installation at http://yoursite/tt-rss/
and login with
default credentials (username: admin
, password:
password
).
Go to preferences and change your password!
You will also need to decide on the method tt-rss uses to update feeds. This is a separate topic, outlined in UpdatingFeeds.
If all went well, you may proceed to use tt-rss normally. Create a separate non-admin user, login under it, and start importing your feeds, subscribing, and configure it to your taste.
That’s all!
Don’t forget to read UpdatingFeeds otherwise your feeds won’t update automatically.
See also: SecuringCacheDirectories
There are many plugins written for tt-rss. You can see the list here: Plugins.
It is highly recommended to temporarily disable any third party themes and user CSS customizations before upgrading. Don’t forget to empty your browser cache if you experience weird bugs right after upgrading.
Note that you should upgrade to the latest version available, installing intermediate releases sequentially is not needed.
Change to tt-rss directory on your server and run:
git pull origin master
That’s it. Proceed to next section.
After the files have been upgraded by newer versions, open tt-rss. It
may complain about missing directives in config.php
. If
that happens, you will need to either merge new stuff from
config.php-dist
to your config.php
or remove
config.php
and rerun the installer (take note to copy
previous value of FEED_CRYPT_KEY
if you have feeds with
authentication enabled).
DO NOT INITIALIZE DATABASE when upgrading. This will remove all your tt-rss data.
Afterwards, you may be redirected to the database updater. Log in with admin credentials and follow instructions.
Finishing that, you should be able to use tt-rss normally by logging in with your normal account.
This will delete the page "InstallationNotes"
. Please be certain.