diff --git a/README.md b/README.md
index 5120899c..ed6b3203 100644
--- a/README.md
+++ b/README.md
@@ -92,12 +92,37 @@ Cmdline options
                           This parameter will be silently ignored if the specified config file does not exist.
                           Options specified on the command line take precedence over those in the config file.
 
-Config file
------------
+Config files
+------------
 
 INI-like, syntax is the following : <key> = <value>.
 All command-line parameters are allowed as keys, for example:
 
+i2p.conf:
+
 	log = 1
 	v6 = 0
 	ircdest = irc.postman.i2p
+
+tunnels.cfg (filename of this config is subject of change):
+
+  ; outgoing tunnel, to remote service
+  [tunnel1]
+  type = client      ; mandatory
+  port = <integer>   ; mandatory, bind our side of tunnel to this local port
+  keys = <filename>  ; optional
+  destination     = <ident>    ; mandatory
+  destinationport = <integer>  ; optional, port of remote i2p service
+  ;
+  ; incoming tunnel, for local service(s)
+  [tunnel2]
+  type = server      ; mandatory
+  host = <ident>     ; mandatory, hostname of our i2p service
+  keys = <filename>  ; mandatory, hostname keys
+  port = <integer>   ; mandatory, forward incoming connections from i2p
+                     ; to this port
+  inport = <integer> ; optional, i2p service port
+  accesslist = <ident>[,<ident>] ; optional, comma-separated list of i2p idents,
+                                 ; allowed to connect to service
+
+Note: '<ident>' type is a string like <hostname.i2p> or <abracadabra.b32.i2p>