From: hal9 <hal9@users.sourceforge.net>
Date: Fri, 11 Oct 2002 03:32:38 +0000 (+0000)
Subject: Sync with recent make install changes, notably the requirement for a non-root
X-Git-Tag: v_3_1_archive_branchpoint~95
X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=commitdiff_plain;h=4880f78d657e6f68dfbde5ffafd026049cb3c216;ds=sidebyside

Sync with recent make install changes, notably the requirement for a non-root
user to exist for the installation. Other touch ups.
---

diff --git a/INSTALL b/INSTALL
index 20c185a2..92c3cdd8 100644
--- a/INSTALL
+++ b/INSTALL
@@ -57,8 +57,9 @@ tree.
 You can also check out any Privoxy "branch", just exchange the current name
 with the wanted branch name (Example: v_3_0_branch for the 3.0 cvs tree).
 
-It is also recommended to not run Privoxy as root, and instead it is suggested
-to create a "privoxy" user for this purpose.
+It is also strongly recommended to not run Privoxy as root, and instead it is
+suggested to create a "privoxy" user and group for this purpose. See your local
+documentation for the correct command line to do this.
 
 /etc/passwd might then look like:
 
@@ -87,10 +88,16 @@ you by just typing:
 
 in the freshly downloaded or unpacked source directory.
 
+WARNING: If installing as root, the install will fail unless another user is
+specified. configure accepts --with-user and --with-group options for setting
+user and group ownership of the configuration files (which need to be writable
+by the daemon). The specified user must already exist. Or if there is already a
+privoxy user on the system, and no user was specified during configure, make
+install then will use the privoxy user. When starting Privoxy, it should be run
+as this same user.
+
 The default installation path for make install is /usr/local. This may of
-course be customized with the various ./configure path options. configure also
-accepts a --with-user and --with-group options for setting user and group
-ownership.
+course be customized with the various ./configure path options.
 
 If you do install to /usr/local, the install will use sysconfdir=$prefix/etc/
 privoxy by default. All other destinations, and the direct usage of
@@ -108,8 +115,9 @@ default to /var instead of $prefix/var so the logs will go to /var/log/privoxy
 /, and the pid file will be created in /var/run/privoxy.pid.
 
 make install will attempt to set the correct values in config (main
-configuration file). If appropriate, an init script will be installed, but it
-is up to the user to determine how and where to start Privoxy.
+configuration file). You may want to check this to make sure all values are
+correct. If appropriate, an init script will be installed, but it is up to the
+user to determine how and where to start Privoxy.
 
 For more detailed instructions on how to build Redhat and SuSE RPMs, Windows
 self-extracting installers, building on platforms with special requirements
@@ -117,3 +125,7 @@ etc, please consult the developer manual.
 
 For binary RPM installation, and other platforms, see the User Manual as well.
 
+The simplest command line to start Privoxy is $path/privoxy --user=privoxy
+$path/etc/privoxy/config. See privoxy --usage, or the man page, for other
+options, and configuration.
+