Installation Guide
Installing Tiny Tiny RSS for the first time
Before you begin, you'll need to verify the following:
1. You need access to a hosting/VDS running a http server and a database (mysql or postgresql).
2. You will need to acquire database credentials, i.e. login, password, and a database name. If you don't have a database already created, you need to do so before installing. Tiny Tiny RSS can coexist with other applications in a shared database, creating a dedicated one is not necessary.
3. Your http server should be running PHP version 5.3 or later. Having an accelerator like php-apc is highly recommended.
After you have gone through the above list, you can proceed to the installation.
1. Unpack the distribution .tar.gz archive into destination directory.
tar zxfv Tiny-Tiny-RSS-1.x.x.tar.gz
It's recommended to rename the directory to tt-rss
for brevity.
mv Tiny-Tiny-RSS-1.x.x tt-rss
Alternatively, you can unpack the distribution on your local machine and upload files to the server using FTP or any other means available to you.
2. Verify that you can open http://your.site.com/tt-rss/install/
3. 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://your.site.com/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.
4. The 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.
5. It is suggested that you read through config.php
to see if you need to enable additional functionality or change default configuration values.
5. After finishing with the installer, open your Tiny Tiny RSS installation at http://your.site.com/tt-rss/
and login with default credentials (username: admin
, password: password
).
6. Go to preferences and change your password!
7. You will also need to decide on the method tt-rss uses to update feeds. This is a separate topic, outlined in UpdatingFeeds.
7. 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.
8. That's all!