i2pd/docs/configuration.md

163 lines
8.1 KiB
Markdown
Raw Normal View History

2016-01-12 07:18:17 +03:00
i2pd configuration
==================
Command line options
--------------------
2016-03-28 03:00:00 +03:00
Options specified on the command line take precedence over those in the config file.
If you are upgrading your very old router (< 2.3.0) see also [this](config_opts_after_2.3.0.md) page.
* --help - Show builtin help message (default value of option will be shown in braces)
* --conf= - Config file (default: ~/.i2pd/i2pd.conf or /var/lib/i2pd/i2pd.conf)
This parameter will be silently ignored if the specified config file does not exist.
* --tunconf= - Tunnels config file (default: ~/.i2pd/tunnels.conf or /var/lib/i2pd/tunnels.conf)
2016-01-20 03:00:00 +03:00
* --pidfile= - Where to write pidfile (dont write by default)
2016-02-03 14:22:00 +03:00
* --log= - Logs destination: stdout, file (stdout if not set, file - otherwise, for compatibility)
* --logfile= - Path to logfile (default - autodetect)
2016-07-12 03:00:00 +03:00
* --loglevel= - Log messages above this level (debug, info, warn, error)
* --datadir= - Path to storage of i2pd data (RI, keys, peer profiles, ...)
2016-04-05 03:00:00 +03:00
* --host= - Router external IP for incoming connections
* --port= - Port to listen for incoming connections (default: auto)
2016-02-03 14:22:00 +03:00
* --daemon - Router will go to background after start
* --service - Router will use system folders like '/var/lib/i2pd'
* --ipv6 - Enable communication through ipv6. false by default
* --notransit - Router will not accept transit tunnels at startup. false by default
* --floodfill - Router will be floodfill. false by default
2016-03-31 03:00:00 +03:00
* --bandwidth= - Bandwidth limit: integer in KBps or letters: L (32), O (256), P (2048), X (>9000)
2016-02-21 05:20:21 +03:00
* --family= - Name of a family, router belongs to
2016-10-12 18:26:48 +03:00
* --netid= - Network ID, router belongs to. Main I2P is 2.
2016-03-31 03:00:00 +03:00
Windows-specific options:
2016-02-03 14:22:00 +03:00
* --svcctl= - Windows service management (--svcctl="install" or --svcctl="remove")
2016-03-31 03:00:00 +03:00
* --insomnia - Prevent system from sleeping
* --close= - Action on close: minimize, exit, ask
2016-01-20 03:00:00 +03:00
2016-03-28 03:00:00 +03:00
All options below still possible in cmdline, but better write it in config file:
2016-01-20 03:00:00 +03:00
* --http.address= - The address to listen on (HTTP server)
* --http.port= - The port to listen on (HTTP server)
* --http.auth - Enable basic HTTP auth for webconsole
* --http.user= - Username for basic auth (default: i2pd)
* --http.pass= - Password for basic auth (default: random, see logs)
2016-01-20 03:00:00 +03:00
2016-11-03 18:46:24 +03:00
* --httpproxy.enabled= - If HTTP proxy is enabled. true by default
* --httpproxy.address= - The address to listen on (HTTP Proxy)
* --httpproxy.port= - The port to listen on (HTTP Proxy) 4444 by default
* --httpproxy.keys= - optional keys file for HTTP proxy local destination
* --httpproxy.inbound.length= - Inbound tunnels length if keys is set. 3 by default
2016-11-03 18:47:33 +03:00
* --httpproxy.inbound.quantity= - Inbound tunnels quantity if keys is set. 5 by default
* --httpproxy.outbound.length= - Outbound tunnels length if keys is set. 3 by default
2016-11-03 18:47:33 +03:00
* --httpproxy.outbound.quantity= - Outbound tunnels quantity if keys is set. 5 by default
2016-01-20 03:00:00 +03:00
2016-11-03 22:28:33 +03:00
* --socksproxy.enabled= - If SOCKS proxy is enabled. true by default
* --socksproxy.address= - The address to listen on (SOCKS Proxy)
* --socksproxy.port= - The port to listen on (SOCKS Proxy). 4447 by default
2016-11-03 18:46:24 +03:00
* --socksproxy.keys= - optional keys file for SOCKS proxy local destination
2016-11-03 22:28:33 +03:00
* --socksproxy.inbound.length= - Inbound tunnels length if keys is set. 3 by default
* --socksproxy.inbound.quantity= - Inbound tunnels quantity if keys is set. 5 by default
* --socksproxy.outbound.length= - Outbound tunnels length if keys is set. 3 by default
* --socksproxy.outbound.quantity= - Outbound tunnels quantity if keys is set. 5 by default
* --socksproxy.outproxy= - Address of outproxy. requests outside i2p will go there
* --socksproxy.outproxyport= - Outproxy remote port
2016-01-20 03:00:00 +03:00
* --sam.address= - The address to listen on (SAM bridge)
* --sam.port= - Port of SAM bridge. Usually 7656. SAM is off if not specified
2016-03-18 20:35:33 +03:00
* --sam.enabled= - If SAM is enabled. false by default
2016-01-20 03:00:00 +03:00
* --bob.address= - The address to listen on (BOB command channel)
* --bob.port= - Port of BOB command channel. Usually 2827. BOB is off if not specified
2016-06-05 17:31:55 +03:00
* --bob.enabled= - If BOB is enabled. false by default
2016-06-23 18:23:06 +03:00
* --i2cp.address= - The address to listen on or an abstract address for Android LocalSocket
* --i2cp.port= - Port of I2CP server. Usually 7654. Ignored for Andorid
* --i2cp.enabled= - If I2CP is enabled. false by default. Other services don't require I2CP
2016-01-20 03:00:00 +03:00
2017-01-05 18:30:27 +03:00
* --i2pcontrol.address= - The address to listen on (I2P control service)
* --i2pcontrol.port= - Port of I2P control service. Usually 7650. I2PControl is off if not specified
* --i2pcontrol.enabled= - If I2P control is enabled. false by default
* --i2pcontrol.password= - I2P control authentication password. itoopie by default
* --i2pcontrol.cert= - I2P control HTTPS certificate file name. i2pcontrol.crt.pem by default
* --i2pcontrol.key= - I2P control HTTPS certificate key file name. i2pcontrol.key.pem by default
2016-04-18 00:03:56 +03:00
2016-07-19 19:05:32 +03:00
* --upnp.enabled= - Enable or disable UPnP, false by default for CLI and true for GUI (Windows, Android)
* --upnp.name= - Name i2pd appears in UPnP forwardings list. I2Pd by default
2016-08-12 17:37:03 +03:00
2016-04-20 22:02:11 +03:00
* --precomputation.elgamal= - Use ElGamal precomputated tables. false for x64 and true for other platforms by default
* --reseed.verify= - Request SU3 signature verification
* --reseed.file= - Full path to SU3 file to reseed from
* --reseed.urls= - Reseed URLs, separated by comma
* --addressbook.defaulturl= - AddressBook subscription URL for initial setup
* --addressbook.subscriptions= - AddressBook subscriptions URLs, separated by comma
2016-04-20 22:02:11 +03:00
* --limits.transittunnels= - Override maximum number of transit tunnels. 2500 by default
* --limits.openfiles= - Maximum size of corefile in Kb (0 - use system limit)
* --limits.coresize= - Maximum size of corefile in Kb (0 - use system limit)
Config files
------------
INI-like, syntax is the following : <key> = <value>.
Comments are "#", not ";" as you may expect. See [boost ticket](https://svn.boost.org/trac/boost/ticket/808)
2016-01-20 03:00:00 +03:00
All command-line parameters are allowed as keys, but note for those which contains dot (.).
For example:
i2pd.conf:
2016-01-20 03:00:00 +03:00
# comment
log = true
ipv6 = true
2016-01-20 03:00:00 +03:00
# settings for specific module
[httpproxy]
port = 4444
# ^^ this will be --httproxy.port= in cmdline
2016-03-28 03:00:00 +03:00
# another comment
2016-01-20 03:00:00 +03:00
[sam]
enabled = true
2016-03-28 03:00:00 +03:00
See also commented config with examples of all options in ``docs/i2pd.conf``.
tunnels.conf:
# outgoing tunnel sample, to remote service
# mandatory parameters:
# * type -- always "client"
# * port -- local port to listen to
# * destination -- i2p hostname
# optional parameters (may be omitted)
# * keys -- our identity, if unset, will be generated on every startup,
# if set and file missing, keys will be generated and placed to this file
2016-01-13 17:42:06 +03:00
# * address -- local interface to bind
2016-07-27 05:00:00 +03:00
# * signaturetype -- signature type for new destination. 0 (DSA/SHA1), 1 (EcDSA/SHA256) or 7 (EdDSA/SHA512)
[IRC]
type = client
2016-01-13 17:42:06 +03:00
address = 127.0.0.1
port = 6668
2016-01-11 05:52:16 +03:00
destination = irc.postman.i2p
keys = irc-keys.dat
#
# incoming tunnel sample, for local service
# mandatory parameters:
2016-01-26 17:45:29 +03:00
# * type -- "server" or "http"
# * host -- ip address of our service
# * port -- port of our service
# * keys -- file with LeaseSet of address in i2p
# optional parameters (may be omitted)
# * inport -- optional, i2p service port, if unset - the same as 'port'
# * accesslist -- comma-separated list of i2p addresses, allowed to connect
# every address is b32 without '.b32.i2p' part
[LOCALSITE]
2016-01-26 17:45:29 +03:00
type = http
host = 127.0.0.1
port = 80
keys = site-keys.dat
2016-03-28 03:00:00 +03:00
#
2016-01-26 17:45:29 +03:00
[IRC-SERVER]
type = server
host = 127.0.0.1
port = 6667
keys = irc.dat
Also see [this page](https://github.com/PurpleI2P/i2pd/wiki/tunnels.cfg) for more tunnel examples.