revup

[friendica.git] / INSTALL.txt

diff --git a/INSTALL.txt b/INSTALL.txt
index 12dca9c5b4992bd72a033ee7d3e0618f2eeff3ef..8de306b7d0cc80e8ccd063052290cdcdfc4d545d 100644 (file)
--- a/INSTALL.txt
+++ b/INSTALL.txt
@@ -12,6 +12,11 @@ blog. Not every PHP/MySQL hosting provider will be able to support Friendika.
 Many will. But please review the requirements and confirm these with your 
 hosting provider prior to installation.
 
 Many will. But please review the requirements and confirm these with your 
 hosting provider prior to installation.
 

+Before you begin: Choose a domain name or subdomain name for your server.
+Put some thought into this - because changing it is currently not-supported.
+Things will break, and some of your friends may have difficulty communicating
+with you. We plan to address this limitation in a future release. 
+ 

 
 1. Requirements
        - Apache with mod-rewrite enabled and "Options All" so you can use a 
 
 1. Requirements
        - Apache with mod-rewrite enabled and "Options All" so you can use a 


@@ -29,7 +34,7 @@ php.ini file
        - Mysql 5.x
 
        - ability to schedule jobs with cron (Linux/Mac) or Scheduled Tasks
        - Mysql 5.x
 
        - ability to schedule jobs with cron (Linux/Mac) or Scheduled Tasks

-(Windows) [Note: other options are presented in Section 7 of this document]
+(Windows) [Note: other options are presented in Section 8 of this document]

 
        - Installation into a top-level domain or sub-domain (without a 
 directory/path component in the URL) is preferred. Directory paths will
 
        - Installation into a top-level domain or sub-domain (without a 
 directory/path component in the URL) is preferred. Directory paths will


@@ -48,10 +53,15 @@ you might have trouble getting everything to work.]
 3. Create an empty database and note the access details (hostname, username, 
 password, database name).
 
 3. Create an empty database and note the access details (hostname, username, 
 password, database name).
 

-4. Visit your website with a web browser and follow the instructions. Please 
+
+4. If you know in advance that it will be impossible for the web server to 
+write or create files in your web directory, create an empty file called 
+.htconfig.php and make it writable by the web server.
+
+5. Visit your website with a web browser and follow the instructions. Please 

 note any error messages and correct these before continuing.
 
 note any error messages and correct these before continuing.
 

-5. *If* the automated installation fails for any reason, check the following:
+6. *If* the automated installation fails for any reason, check the following:

 
        - ".htconfig.php" exists 
                If not, edit htconfig.php and change system settings. Rename 
 
        - ".htconfig.php" exists 
                If not, edit htconfig.php and change system settings. Rename 


@@ -60,7 +70,7 @@ to .htconfig.php
                If not, import the contents of "database.sql" with phpmyadmin 
 or mysql command line
 
                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. 
+7. At this point visit your website again, and register your personal account. 

 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 
 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 


@@ -73,7 +83,7 @@ tables, so that you can start fresh.
 ****************************************************************************
 ****************************************************************************
 
 ****************************************************************************
 ****************************************************************************
 

-7. Set up a cron job or scheduled task to run the poller once every 5-10 
+8. Set up a cron job or scheduled task to run the poller once every 5-10 

 minutes to pick up the recent "public" postings of your friends. Example:
 
        cd /base/directory; /path/to/php include/poller.php
 minutes to pick up the recent "public" postings of your friends. Example:
 
        cd /base/directory; /path/to/php include/poller.php