Installation
From GregariusWiki
Contents |
[edit] Pre-Installation
Before you install Gregarius make sure you know how to access an Apache web server with PHP (4.3+ recommended) installed. You will also need access to a database like MySQL. SQLite is also supported in versions greater than 0.5.0a. Gregarius has also been known to run on other webservers.
[edit] Installation
- Unpack the Gregarius archive on your web server. If you are installing from a tar.gz archive, type:
tar xvfz rss-x.y.z.tar.gz
- Otherwise, if you are installing from a zipped archive, type:
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.
- If you have unzipped the files on your desktop and transferred them to your computer with FTP or SCP, ensure that .htaccess was copied. Some desktop operating systems (including OSX and Linux) hide all files that have names begining with a dot (.).
- After changing to the new Gregarius directory, create a configuration file to allow Gregarius to access your database. You can copy the sample configuration file to use as a template:
cp dbinit.php.sample dbinit.php
- You will want to edit dbinit.php to match your database configuration. Make sure that the database exists and that the database user you define should have privileges to create tables in the database. If this is not the case then you should import your schema manually by using the command line to type (replacing database_user, database_host and database_name).
mysql -u database_user -h database_host -p database_name < dbstruct.sql
Alternatively you can use PHPMyAdmin (if available) to add the required tables by following these instructions.
- Point your browser to the root directory of your installation. You should see a message informing you that the database schema has been generated.
- Dance, for you have successfully installed Gregarius.
- If you need help with the installation process, click here to see several options.
[edit] Post-Installation
- You may wish to import your feeds if you are switching from another RSS aggregator.
- You can password-protect the administration section of your fresh Gregarius installation, to prevent unauthorized users from messing with your subscriptions and breaking stuff.
- You may want to automatically update your feeds in the background.(using cron, or without using cron)
[edit] Special Notes for installing the latest nightlies (0.5.5)
- The dbstruct.sql file has been removed and to generate it you need to use
php schema.php --dump
- There is an installer program install.php which helps you configure gregarius. Before 0.5.6 is released, instructions to use the installer will replace the installation instructions above.
