# etc/polipo/config - Configuration file for Polipo
# License:  "polipo" 1.0.4.1 license
# Revision: 100919

#---------------------------------------------------------------------
# Overview.

# This file defines some settings for Polipo.  It should be  stored in
# Polipo's "etc/polipo" subdirectory.

# Note: This file only lists some of the configuration variables.  For
# more information,  see the list given by  "polipo -v" and  the  pro-
# gram's manual.

#---------------------------------------------------------------------
# Basic configuration.

# If you'd like to allow remote clients to use  Polipo,  uncomment ex-
# actly one of these settings:
#
# proxyAddress = "::0"                  # Both IPv4 and IPv6
# proxyAddress = "0.0.0.0"              # IPv4 only

# Note: This isn't recommended unless you understand the risks involv-
# ed.

# If you open up the proxy as explained  above,  you  should  restrict
# clients based on IP address and/or subnet.  To do so,  uncomment ex-
# actly one of these settings and  modify the IP address and/or subnet
# value appropriately:
#
# allowedClients = "134.157.168.57"     # IP address
# allowedClients = "134.157.168.0/24"   # Subnet

# Uncomment these definitions if you want to use a parent proxy:
# parentHost = "squid.example.org"
# parentPort = 3128

#---------------------------------------------------------------------
# Proxy identification.

# By  default, Polipo identifies itself to the  outside world and uses
# the hostname to do so.

# Recommended action:  Disable this kind of identification.  To do so,
# set "proxyName" and "disableVia" as follows:
#
#     proxyName  = "Polipo"
#     disableVia = true

# If you prefer  the  default mode of operation,  comment-out the fol-
# lowing settings.

proxyName  = "Polipo"
disableVia = true

#---------------------------------------------------------------------
# Memory.

# If you'd like Polipo to use a very small amount of memory, uncomment
# these two settings:
#
# chunkHighMark = 819200
# objectHighMark = 128

# Alternatively, if you'd like Polipo to use a large amount of memory,
# uncomment these settings instead:
#
# chunkHighMark = 50331648
# objectHighMark = 16384

#---------------------------------------------------------------------
# On-disk data.

# "diskCacheRoot"  may be set  to  an empty string  or to a  directory
# path.  If it's an empty string,  Polipo's on-disk cache is disabled.
# If it's a directory  path,  Polipo stores the  on-disk cache  in the
# specified directory.

# If  "diskCacheRoot" isn't set  at all,  Polipo  stores  the  on-disk
# cache in a default location.

# Note:  The directory path (if any) should end with a trailing slash.
# The directory must  exist initially.  If Polipo is running as an un-
# privileged user (recommended), the user needs to have read/write ac-
# cess to the specified directory.

# To put the  on-disk cache  somewhere  besides the  default location,
# modify this setting appropriately and uncomment it:
#
# diskCacheRoot = "~/.polipo-cache/"

# To disable the on-disk cache (and use the memory cache only), uncom-
# ment this and set to an empty string:
#
diskCacheRoot = ""

#---------------------------------------------------------------------
# DNS-related settings.

# Uncomment this if you want to contact IPv4 hosts only  (and make DNS
# queries somewhat faster):
#
dnsQueryIPv6 = no

# Uncomment this if you want Polipo to prefer IPv4 to IPv6 for double-
# stack hosts:
#
# dnsQueryIPv6 = reluctantly

# Uncomment this and  set to yes to disable Polipo's  DNS resolver and
# use "gethostbyname" instead.  Note: If you do this, Polipo may pause
# during DNS queries:
#
# dnsUseGethostbyname = yes

#---------------------------------------------------------------------
# Misc. settings.

# The following "serverSlots" setting is experimental. For more infor-
# mation, see the "polipo" manual.
#
serverSlots = 3

# Uncomment this  and set to an  empty string  if you want to  disable
# Polipo's built-in web server:
#
# localDocumentRoot = ""

# Uncomment this and set to yes if you have no network:
#
# proxyOffline = yes

# For more information about these settings, see the Polipo manual:
#
# Size in bytes to which on-disk objects are  truncated  (when trunca-
# tion is necessary):
#
diskCacheTruncateSize = 786432
#
# Time delay until on-disk objects are truncated  (for  example,  365d
# for 365 days, 4d12h for 4 days 12 hours, 30m for 30 minutes, etc.):
#
diskCacheTruncateTime = 30m
#
# Time delay until on-disk objects are deleted (same units as above):
#
diskCacheUnlinkTime = 365d

# These  two settings are  an attempt to  solve a  problem  related to
# Google:
#
dontCacheCookies = true
dontCacheRedirects = true

# This setting specifies the  location of a  text file  that specifies
# domains that should be forbidden:
#
forbiddenFile = __META_PREFIX__/etc/polipo/forbidden
