X-Git-Url: http://www.privoxy.org/gitweb/?p=privoxy.git;a=blobdiff_plain;f=doc%2Fwebserver%2Fuser-manual%2Fstartup.html;h=1fe9cc03cfd90781b3982cfe6e6d577fa9047a92;hp=96baff2964b60afb132b919c9755234aa0798dad;hb=e0dbf1d74567dc0bec4c358a3bab44ef62af4aa8;hpb=0a3750f6302df8349b5be2e15a9a4fefe3c35889 diff --git a/doc/webserver/user-manual/startup.html b/doc/webserver/user-manual/startup.html index 96baff29..1fe9cc03 100644 --- a/doc/webserver/user-manual/startup.html +++ b/doc/webserver/user-manual/startup.html @@ -80,14 +80,14 @@ CLASS="APPLICATION" > Before launching Privoxy for the first time, you - will want to configure your browser(s) to use for the first time, you + will want to configure your browser(s) to use + Privoxy - as a HTTP and HTTPS proxy. The default is localhost for the proxy address, - and port 8118 (earlier versions used port 8000). This is the one - configuration step that must be done!

as a HTTP and HTTPS proxy. The default is + localhost for the proxy address, and port 8118 (earlier versions used port + 8000). This is the one configuration step that must be done!

With Privoxy is typically started by specifying the - main configuration file to be used on the command line. Example Unix startup - command:

Privoxy
+ will look for a file named config in the current + directory. Except on Win32 where it will try config.txt.

6.1. RedHat and Debian

We use a script. Note that RedHat does not start Privoxy upon booting per +default. It will use the file /etc/privoxy/config as its +main configuration file. FIXME: Debian??

 
- # /usr/sbin/privoxy /etc/privoxy/config
# /etc/rc.d/init.d/privoxy start

6.2. SuSE

See below for other command line options.

An init script is provided for SuSE and Red Hat.

For for SuSE: rcprivoxy start

We use a script. It will use the file /etc/privoxy/config +as its main configuration file. Note that SuSE starts Privoxy upon booting +your PC.

For Red Hat and Debian: /etc/rc.d/init.d/privoxy start
 # rcprivoxy start

6.3. Windows

If no configuration file is specified on the command line, - Click on the Privoxy Icon to start Privoxy. If no configuration file is + specified on the command line, Privoxy will look for a file named - config in the current directory. Except on Win32 where - it will try will look + for a file named config.txt. If no file is specified on the - command line and no default configuration file can be found, - Privoxy will fail to start.

The included default configuration files should give a reasonable starting - point. Most of the per site configuration is done in the - "actions" files. These are where various cookie actions are - defined, ad and banner blocking, and other aspects of - Privoxy configuration. There are several such - files included, with varying levels of aggressiveness.

You will probably want to keep an eye out for sites for which you may prefer - persistent cookies, and add these to your actions configuration as needed. By - default, most of these will be accepted only during the current browser - session (aka "session cookies"), unless you add them to the - configuration. If you want the browser to handle this instead, you will need - to edit user.action (or through the web based interface) - and disable this feature. If you use more than one browser, it would make - more sense to let Privoxy handle this. In which - case, the browser(s) should be set to accept all cookies.

Another feature where you will probably want to define exceptions for trusted - sites is the popup-killing (through the +popup and - +filter{popups} actions), because your favorite shopping, - banking, or leisure site may need popups (explained below).

Privoxy is HTTP/1.1 compliant, but not all of - the optional 1.1 features are as yet supported. In the unlikely event that - you experience inexplicable problems with browsers that use HTTP/1.1 per default - (like Mozilla or recent versions of I.E.), you might - try to force HTTP/1.0 compatibility. For Mozilla, look under Edit -> - Preferences -> Debug -> Networking. - Alternatively, set the "+downgrade-http-version" config option in - default.action which will downgrade your browser's HTTP - requests from HTTP/1.1 to HTTP/1.0 before processing them.

. Note that Windows will + automatically start Privoxy upon booting you PC.

6.4. Solaris, NetBSD, FreeBSD, HP-UX and others

After running Privoxy for a while, you can - start to fine tune the configuration to suit your personal, or site, - preferences and requirements. There are many, many aspects that can - be customized. "Actions" - can be adjusted by pointing your browser to - http://config.privoxy.org/ - (shortcut: http://p.p/), - and then follow the link to "View & Change the Current Configuration". - (This is an internal page and does not require Internet access.)

Example Unix startup command:

In fact, various aspects of Privoxy - configuration can be viewed from this page, including - current configuration parameters, source code version numbers, - the browser's request headers, and "actions" that apply - to a given URL. In addition to the actions file - editor mentioned above, Privoxy can also - be turned "on" and "off" (toggled) from this page.

 # /usr/sbin/privoxy /etc/privoxy/config

6.5. OS/2

If you encounter problems, try loading the page without - Privoxy. If that helps, enter the URL where - you have the problems into the browser - based rule tracing utility. See which rules apply and why, and - then try turning them off for that site one after the other, until the problem - is gone. When you have found the culprit, you might want to turn the rest on - again.

FIXME.

6.6. MAX OSX

If the above paragraph sounds gibberish to you, you might want to read more about the actions concept - or even dive deep into the Appendix - on actions.

FIXME.

6.7. AmigaOS

If you can't get rid of the problem at all, think you've found a bug in - Privoxy, want to propose a new feature or smarter rules, please see the - section "Contacting the - Developers" below.

FIXME.

6.1. Command Line Options6.8. Command Line Options