Requirements

- A MySQL database;
- A PHP (4 or 5) host;
- PHP cURL functions enabled (libcurl)
- (Optional) A host that allow .htaccess files and AuthUserFile (password protection) commands.
- (Optional) PHP 5 if you want to publish starred items to ma.gnolia.
- Firefox (or Safari) is strongly recommended; GobbleRSS has never been tested on IE.


Installation Instructions

1. Create the MySQL database and user:
CREATE DATABASE gobblerss;
GRANT ALL ON gobblerss.* TO gobblerss_user@localhost IDENTIFIED BY 'some_password';
Those are examples; all those values can be changed to fit your needs.

2. Edit config.inc.php:
a) URI should point to the URL when GobbleRSS will be available.
b) log_file should point to a log file where logs will be kept. Leave it empty '' if you don't want any log. This file should be editable by the user running the web server (usually apache).
c) mysql_xyz are the information required to connect to your MySQL database.
d) max_articles_per_spider_page is the number of articles that will be shown on the 'spider' page (i.e. the page used for PDA syncing). Ignore if you won't use that.
e) The other options are configuration options for your Starred Articles RSS feed. They should be self-explanatory.

3. Edit .htaccess to fit your needs. I personally allow my home IP to access the website without passwords (Allow from my_ip lines), and I setup a password for when I want to read my RSS feeds from somewhere else. The default .htaccess will only allow 127.0.0.1 and has no password (the password lines are commented out). You'll need to either add another Allow from xyz line with your IP address, or create your own htpasswd and un-comment the appropriate lines.

4. Upload all the files to your web host.

5. Make sure the cache directory is writable by the user running the web server:
Example:
chown apache /path/to/gobblerss/cache
Or you can make it world writable (777):
Example:
chmod 777 /path/to/gobblerss/cache
You FTP client probably has an option to change file & directories permissions.

6. (Optional) Also make sure the log file your specified in the config.inc.php is writable by the user running the web server:
Example:
chown apache /path/to/gobblerss/GobbleRSS.log

7.a) If you have access to cron, create a cron job to call http://your_url_for_gobblerss/ping.php at regular interval (I suggest every 6 hours).
Example:
0 */6 * * * curl -s -o /dev/null http://your_url_for_gobblerss/ping.php
You'll need to edit .htaccess and change the first IP you'll find to the IP of your web host. This is the IP that is allowed to call ping.php - you don't want to allow anyone to call the URL!

b) If you don't have access to cron, you can use the GobbleRSS Ping-Service available here: http://ping.gobblerss.pommepause.com/
Simply enter your http://your_url_for_gobblerss in the form on this website, and the Ping-Service will ping your GobbleRSS at regular intervals.
The GobbleRSS Ping-Service should start pinging your installation within 15 minutes after you submitted the web form.

You're all set. Point your browser to http://your_url_for_gobblerss to start using GobbleRSS. The Subscriptions link is probably a good start!

Optionally, if you already use another RSS reader and you want to import your feeds into GobbleRSS, you can use the OPML loader.
(Google Reader can export subscriptions in OPML format - in the settings pages I think).

Simply upload the OPML file exported by your RSS reader on your web host, in the same directory as load_opml.php, and load this URL in your browser (change filename.opml to the filename you just uploaded):
http://your_url_for_gobblerss/load_opml.php?file=filename.opml