friendica/INSTALL

78 lines
2.9 KiB
Plaintext
Raw Normal View History

2010-07-11 06:35:06 -04:00
2010-11-02 23:17:46 -04:00
Friendika Installation
2010-07-11 06:35:06 -04:00
1. Requirements
2010-07-28 19:28:39 -04:00
- Apache with mod-rewrite enabled and "Options All" so you can use a
local .htaccess file
2010-09-21 19:01:19 -04:00
2010-07-28 19:28:39 -04:00
- PHP > 5.1. The later the better. You'll need 5.3 for full openssl
encryption support
- PHP *command line* access with register_argc_argv set to true in the
2010-07-28 19:28:39 -04:00
php.ini file
2010-11-16 18:38:56 -05:00
- curl, gd, and openssl extensions
2010-09-21 19:01:19 -04:00
2010-07-11 06:35:06 -04:00
- Mysql 5.x
2010-09-21 19:01:19 -04:00
- ability to schedule jobs with cron (Linux/Mac) or Scheduled Tasks
(Windows)
2010-07-28 19:28:39 -04:00
[Dreamhost.com offers all of the necessary hosting features at a
reasonable price. If your hosting provider doesn't allow Unix shell access,
you might have trouble getting everything to work.]
2010-07-11 06:35:06 -04:00
2010-09-21 19:01:19 -04:00
2. Put this directory into the root of your web server document area.
2010-07-11 06:35:06 -04:00
2010-09-21 19:01:19 -04:00
- If you copy the directory tree to your webserver, make sure
that you also copy .htaccess - as "dot" files are often hidden
and aren't normally copied.
2010-07-11 06:35:06 -04:00
2010-09-21 19:01:19 -04:00
- To use a subdirectory of your main domain, set the
2010-07-11 06:35:06 -04:00
config variable $a->path to the relative subdir
2010-07-28 19:28:39 -04:00
in .htconfig.php - for example to use http://example.com/test -
2010-09-21 19:01:19 -04:00
use
$a->path = 'test';
NOTE: This has NOT been fully tested!
2010-09-21 19:01:19 -04:00
In this case, you cannot use the web installer.
Skip step 4 and proceed to step 5 - especially steps 5a and 5b.
2010-09-21 19:01:19 -04:00
2010-07-28 19:28:39 -04:00
- Everything will work much better if you can dedicate a domain
or subdomain so that you don't require an extra server path.
2010-07-11 06:35:06 -04:00
3. Create an empty database and note the access details (hostname, username, password, database name).
2010-09-21 19:01:19 -04:00
4. Visit your website with a web browser and follow the instructions.
2010-09-21 19:01:19 -04:00
5. *If* the automated installation fails for any reason, check the following:
5a. ".htconfig.php" exists
2010-09-21 19:01:19 -04:00
If not, edit htconfig.php and change system settings. Rename
to .htconfig.php
5b. Database is populated.
2010-09-21 19:01:19 -04:00
If not, import the contents of "database.sql" with phpmyadmin
or mysql command line
6. At this point visit your website again, and register your personal account.
2010-09-21 19:01:19 -04:00
Registration errors should all be recoverable automatically.
If you get any *critical* failure at this point, it generally indicates the
database was not installed correctly. You might wish to move/rename
.htconfig.php to another name and empty (called 'dropping') the database
tables, so that you can start fresh.
7. Set up a cron job or scheduled task to run the poller once every 5-10
2010-09-21 19:01:19 -04:00
minutes to pick up the recent "public" postings of your friends. Example:
cd /base/directory; /path/to/php include/poller.php
Change "/base/directory", and "/path/to/php" as appropriate for your situation.
If you are using a Linux server, run "crontab -e" and add a line like the
one shown, substituting for your unique paths and settings:
2010-07-11 06:35:06 -04:00
2010-09-21 19:01:19 -04:00
*/5 * * * * cd /home/myname/mywebsite; /usr/bin/php include/poller.php
2010-07-11 06:35:06 -04:00
2010-09-21 19:01:19 -04:00
You can generally find the location of PHP by executing "which php". If you
have troubles with this section please contact your hosting provider for
2010-11-02 23:17:46 -04:00
assistance. Friendika will not work correctly if you cannot perform this step.