man pages section 1: User Commands

Exit Print View

Updated: July 2014

privoxy (1)


privoxy - Privacy Enhancing Proxy


privoxy  [--help  ]  [--version  ] [--no-daemon ] [--pidfile
pidfile ] [--user user[.group] ] [--chroot ]  [--pre-chroot-
nslookup hostname ] [configfile ]


User Commands                                          PRIVOXY(1)

     privoxy - Privacy Enhancing Proxy

     privoxy  [--help  ]  [--version  ] [--no-daemon ] [--pidfile
     pidfile ] [--user user[.group] ] [--chroot ]  [--pre-chroot-
     nslookup hostname ] [configfile ]

     Privoxy  may  be  invoked  with  the  following command line

          Print brief usage info and exit.

          Print version info and exit.

          Don't  become  a daemon, i.e.  don't  fork  and  become
          process  group  leader,  don't  detach from controlling
          tty, and do all logging there.

     --pidfile pidfile
          On startup, write the process ID  to  pidfile.   Delete
          the  pidfile  on exit.  Failure to create or delete the
          pidfile is non-fatal. If no --pidfile option is  given,
          no PID file will be used.

     --user user[.group]
          After  (optionally)  writing  the  PID file, assume the
          user ID of user and  the  GID  of  group,  or,  if  the
          optional  group  was  not  given,  the default group of
          user. Exit if the privileges are not sufficient  to  do

          Before  changing  to  the  user  ID given in the --user
          option, chroot to that user's home directory, i.e. make
          the  kernel  pretend  to  the  Privoxy process that the
          directory tree starts there. If set up carefully,  this
          can  limit  the  impact  of possible vulnerabilities in
          Privoxy to the files contained in that hierarchy.

     --pre-chroot-nslookup hostname
          Initialize the resolver library using  hostname  before
          chroot'ing.  On some systems this reduces the number of
          files that must be copied into the chroot tree.

     If the configfile is not specified on  the   command   line,
     Privoxy   will   look for a file named config in the current

Privoxy 3.0.17    Last change: 13 November 2010                 1

User Commands                                          PRIVOXY(1)

     directory. If no configfile is found, Privoxy will  fail  to

     Privoxy  is  a non-caching web proxy with advanced filtering
     capabilities for enhancing privacy, modifying web page  data
     and  HTTP  headers, controlling access, and removing ads and
     other obnoxious Internet junk. Privoxy has a  flexible  con-
     figuration  and  can  be customized to suit individual needs
     and tastes.  It has application for both stand-alone systems
     and multi-user networks.

     Privoxy is Free Software and licensed under the GNU GPLv2.

     Privoxy  is  an associated project of Software in the Public
     Interest (SPI).

     Helping hands and donations are welcome:



     Browsers  can  either  be  individually  configured  to  use
     Privoxy  as  a  HTTP  proxy (recommended), or Privoxy can be
     combined with a packet filter to build an intercepting proxy
     (see  config).   The  default setting is  for localhost,  on
     port  8118 (configurable in the main config file).   To  set
     the  HTTP proxy in Firefox, go through: Tools; Options; Gen-
     eral; Connection Settings; Manual Proxy Configuration.

     For Internet Explorer, go through: Tools;  Internet  Proper-
     ties; Connections; LAN Settings.

     The  Secure  (SSL) Proxy should also be set to the same val-
     ues, otherwise  https:  URLs  will  not  be  proxied.  Note:
     Privoxy can only proxy HTTP and HTTPS traffic. Do not try it
     with FTP or other protocols.  HTTPS  presents  some  limita-
     tions,  and  not  all  features will work with HTTPS connec-

     For other browsers, check the documentation.

     Privoxy can be configured  with  the  various  configuration
     files.   The   default   configuration  files  are:  config,
     default.filter,    default.action    and     default.action.
     user.action should be used for locally defined exceptions to
     the default rules in  match-all.action  and  default.action,
     and  user.filter for locally defined filters. These are well
     commented.  On Unix and Unix-like systems, these are located

Privoxy 3.0.17    Last change: 13 November 2010                 2

User Commands                                          PRIVOXY(1)

     in /etc/privoxy/ by default.

     Privoxy  uses  the concept of actions in order to manipulate
     the data stream between the browser and remote sites.  There
     are  various  actions  available with specific functions for
     such things as blocking web sites,  managing  cookies,  etc.
     These  actions  can be invoked individually or combined, and
     used against individual URLs, or groups of URLs that can  be
     defined  using wildcards and regular expressions. The result
     is that the user has greatly enhanced control and freedom.

     The actions list (ad blocks, etc)  can  also  be  configured
     with  your web browser at (assum-
     ing the configuration allows it).   Privoxy's  configuration
     parameters   can  also  be viewed at the same page. In addi-
     tion, Privoxy can be toggled on/off.  This  is  an  internal
     page, and does not require Internet access.

     See  the User Manual for a detailed explanation of installa-
     tion, general usage, all configuration options, new features
     and notes on upgrading.


     Various other files should be included, but may vary depend-
     ing on platform and build configuration. Additional documen-
     tation  should be included in the local documentation direc-

     Privoxy terminates on the SIGINT, SIGTERM and  SIGABRT  sig-
     nals.  Log  rotation  scripts  may cause a re-opening of the
     logfile by sending a SIGHUP to  Privoxy.  Note  that  unlike
     other  daemons,   Privoxy  does not need to be made aware of
     config file changes by SIGHUP -- it will detect  them  auto-

     See   attributes(5)   for   descriptions  of  the  following

Privoxy 3.0.17    Last change: 13 November 2010                 3

User Commands                                          PRIVOXY(1)

     |Availability   | web/proxy/privoxy |
     |Stability      | Committed         |
     Please see the User Manual on how to contact the developers,
     for  feature  requests,  reporting problems, and other ques-

     Other references and sites of interest to Privoxy users:, the Privoxy Home page., the Privoxy FAQ., the Privoxy devel-
     oper manual.,  the  Project Page
     for Privoxy on SourceForge., the  web-based  user  interface.
     Privoxy   must  be  running  for  this  to  work.  Shortcut:
     to submit ``misses'' and other configuration related sugges-
     tions to the developers.

      Fabian Keil, lead developer
      David Schmidt, developer

      Hal Burgiss
      Mark Miller
      Gerry Murphy
      Lee Rian
      Roland Rosenfeld

     Copyright (C) 2001-2010 by Privoxy Developers <ijbswa-devel->

     Some  source  code  is  based  on code Copyright (C) 1997 by
     Anonymous Coders and Junkbusters, Inc.  and  licensed  under
     the GNU General Public License.

Privoxy 3.0.17    Last change: 13 November 2010                 4

User Commands                                          PRIVOXY(1)

     Privoxy  is  free  software;  you can redistribute it and/or
     modify it under the terms of the GNU General Public License,
     version 2, as published by the Free Software Foundation.

     This program is distributed in the hope that it will be use-
     ful, but WITHOUT ANY WARRANTY; without even the implied war-
     POSE.  See the  GNU General Public License for details.

     You should have received a copy of the GNU  GPL  along  with
     this  program;  if  not, write to the  Free Software Founda-
     tion, Inc.  51  Franklin  Street,  Fifth  Floor  Boston,  MA
     02110-1301 USA

     This   software   was   built   from   source  available  at   The   original
     community   source   was   downloaded   from    http://down-

     Further  information about this software can be found on the
     open source community website at

Privoxy 3.0.17    Last change: 13 November 2010                 5