allow the cmd installer to load the config file from '/etc/gnusocial/config.d/'....

[quix0rs-gnu-social.git] / INSTALL

diff --git a/INSTALL b/INSTALL
index 64f30139bf92eea2c673bdc4bccbabe9567d45e6..06f3a23ee12e8db92cb06fabe073d38951c3e0fd 100644 (file)
--- a/INSTALL
+++ b/INSTALL
@@ -109,11 +109,13 @@ especially if you've previously installed PHP/MariaDB packages.
    will enable "Fancy URL" support, which you can read more about if you
    scroll down a bit in this document.
 
-3. Make your target directory writeable by the Web server.
+3. Make your target directory writeable by the Web server, please note
+   however that 'a+w' will give _all_ users write access and securing the
+   webserver is not within the scope of this document.
 
        chmod a+w /var/www/gnusocial/
 
-   On some systems, this will probably work:
+   On some systems, this will work as a more secure alternative:
 
        chgrp www-data /var/www/gnusocial/
        chmod g+w /var/www/gnusocial/
@@ -122,18 +124,7 @@ especially if you've previously installed PHP/MariaDB packages.
    that user's default group instead. As a last resort, you can create
    a new group like "gnusocial" and add the Web server's user to the group.
 
-4. You should also take this moment to make your avatar, background, and
-   file subdirectories writeable by the Web server. An insecure way to do
-   this is:
-
-       chmod a+w /var/www/gnusocial/avatar
-       chmod a+w /var/www/gnusocial/background
-       chmod a+w /var/www/gnusocial/file
-
-   You can also make the avatar, background, and file directories
-   writeable by the Web server group, as noted above.
-
-5. Create a database to hold your site data. Something like this
+4. Create a database to hold your site data. Something like this
    should work (you will be prompted for your database password):
 
        mysqladmin -u "root" -p create social
@@ -146,7 +137,7 @@ especially if you've previously installed PHP/MariaDB packages.
    a tool like phpMyAdmin to create a database. Check your hosting
    service's documentation for how to create a new MariaDB database.)
 
-6. Create a new database account that GNU Social will use to access the
+5. Create a new database account that GNU Social will use to access the
    database. If you have shell access, this will probably work from the
    MariaDB shell:
 
@@ -158,7 +149,7 @@ especially if you've previously installed PHP/MariaDB packages.
    to your preferred new database username and password. You may want to
    test logging in to MariaDB as this new user.
 
-7. In a browser, navigate to the GNU Social install script; something like:
+6. In a browser, navigate to the GNU Social install script; something like:
 
        https://social.example.net/install.php
 
@@ -166,7 +157,7 @@ especially if you've previously installed PHP/MariaDB packages.
    install program will configure your site and install the initial,
    almost-empty database.
 
-8. You should now be able to navigate to your social site's main directory
+7. You should now be able to navigate to your social site's main directory
    and see the "Public Timeline", which will probably be empty. You can
    now register new user, post some notices, edit your profile, etc.
 
@@ -365,12 +356,12 @@ Two mechanisms are available to achieve offline operations:
 ### OpportunisticQM plugin
 
 This plugin is enabled by default. It tries its best to do background
-job during regular HTTP requests, like API or HTML pages calls.
+jobs during regular HTTP requests, like API or HTML pages calls.
 
 Since queueing system is enabled by default, notices to be broadcasted
 will be stored, by default, into DB (table queue_item).
 
-Each time it can, OpportunisticQM will try to handle some of them.
+Whenever it has time, OpportunisticQM will try to handle some of them.
 
 This is a good solution whether you: