You are here: Gregarius - Devlog » docs » install

Gregarius Installation

  1. If you are upgrading from an earlier version make sure you have a backup copy of all the files you have modified

  2. If you haven’t already done so, download the latest release from the sourceforge.net project site.

  3. Unpack the Gregarius package inside your web root:

    1. If you are installing from a tar.gz archive:

      tar xvfz rss-x.y.z.tar.gz

    2. If you are installing from a zipped archive:

      unzip rss-x.y.z.zip

    This will unpack the archive to a rss/ directory. Feel free to rename it to anything that suits you.

  4. cd to the created directory:

    cd rss

  5. Create a configuration file, based on the sample:

    1. Copy the sample database configuration file:

      cp dbinit.php.sample dbinit.php

    2. Edit the dbinit.php file to match your database configuration. Make sure that the database user you define owns privileges to create tables.

  6. Point your browser to the root directory of your installtion. You should read a message informing you that the database schema has been generated.

    If the database user you defined lacks privileges to create database tables you should import your schema manually: from the command-line type (replacing database_user, database_host and database_name)

    mysql -u database_user -h database_host -p database_name < dbstruct.sql

  7. Point your browser to the URL corresponding the install location and click “Admin”. You can start adding feeds by pasting URLs of RSS or RDF feeds into the “Add a feed” field. Alternatively you can import a whole structure of items using the OPML import feature.

  8. You may wish to password-protect the administration section of your fresh gregarius installation, to prevent unathorized users from messing with your subscriptions and breaking stuff. See here for this purpose.

Sponsored links

Record Songs for free | Debt | The eBay Song | Mobile Phone | Debt Management