Skip site navigation (1)Skip section navigation (2)

FreeBSD Manual Pages

  
 
  

home | help
GeoIP.conf(7)		Miscellaneous Information Manual	   GeoIP.conf(7)

NAME
     GeoIP.conf - Configuration file for geoipupdate

SYNOPSIS
     This  file  allows  you  to  configure your geoipupdate program to download
     GeoIP2 and GeoLite2 databases.

DESCRIPTION
     The file consists of one setting per line. Lines starting with #  are  com-
     ments and will not be processed. All setting keywords are case sensitive.

   Required settings:
     AccountID
	Your  MaxMind account ID. This was formerly known as UserId. This can be
	overridden at run time	by  either  the  GEOIPUPDATE_ACCOUNT_ID  or  the
	GEOIPUPDATE_ACCOUNT_ID_FILE environment variables.

     LicenseKey
	Your  case-sensitive  MaxMind license key. This can be overridden at run
	time  by   either   the   GEOIPUPDATE_LICENSE_KEY   or	 GEOIPUPDATE_LI-
	CENSE_KEY_FILE environment variables.

     EditionIDs
	List of space-separated database edition IDs. Edition IDs may consist of
	letters,  digits,  and	dashes.  For example, GeoIP2-City would download
	the GeoIP2 City database (GeoIP2-City). This can be  overridden  at  run
	time by the GEOIPUPDATE_EDITION_IDS environment variable. Note: this was
	formerly called ProductIds.

   Optional settings:
     DatabaseDirectory
	The  directory	to  store the database files. If not set, the default is
	DATADIR. This can be overridden at run time  by  the  GEOIPUPDATE_DB_DIR
	environment variable or the -d command line argument.

     Host
	The  host name of the server to use. The default is https://updates.max-
	mind.com.  This can be overridden at run time  by  the	GEOIPUPDATE_HOST
	environment variable.

     Proxy
	The  proxy  host  name	or IP address. You may optionally specify a port
	number, e.g., 127.0.0.1:8888. If no port number is specified, 1080  will
	be used. This can be overridden at run time by the GEOIPUPDATE_PROXY en-
	vironment variable.

     ProxyUserPassword
	The  proxy  user  name and password, separated by a colon. For instance,
	username:password. This can be overridden at run time  by  the	GEOIPUP-
	DATE_PROXY_USER_PASSWORD environment variable.

     PreserveFileTimes
	Whether  to  preserve  modification  times  of files downloaded from the
	server. This option is either 0 or 1. The default  is  0.  This  can  be
	overridden  at	run time by the GEOIPUPDATE_PRESERVE_FILE_TIMES environ-
	ment variable.

     LockFile
	The lock file to use. This ensures only one geoipupdate process can  run
	at  a  time.  Note:  Once created, this lockfile is not removed from the
	filesystem. The default is .geoipupdate.lock  under  the  DatabaseDirec-
	tory.  This  can  be overridden at run time by the GEOIPUPDATE_LOCK_FILE
	environment variable.

     RetryFor
	The amount of time to retry for when errors during HTTP transactions are
	encountered. It can be specified as a (possibly fractional) decimal num-
	ber followed by  a  unit  suffix.  Valid  time	units  are  ns,  us  (or
	A<micro>s),  ms,  s,  m,  h.  The default is 5m (5 minutes). This can be
	overridden at run time by the  GEOIPUPDATE_RETRY_FOR  environment  vari-
	able.

     Parallelism
	The  maximum  number  of  parallel database downloads. The default is 1,
	which means that databases will be downloaded sequentially. This can  be
	overridden  at run time by the GEOIPUPDATE_PARALLELISM environment vari-
	able or the --parallelism command line argument.

   Deprecated settings:
     The following are deprecated and will be ignored if present:

     Protocol

     SkipPeerVerification

     SkipHostnameVerification

SEE ALSO
     geoipupdate(1)

								   GeoIP.conf(7)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=GeoIP.conf&sektion=5&manpath=FreeBSD+Ports+15.1.quarterly>

home | help