bitlbee.conf

   1 ## BitlBee default configuration file
   2 ##
   3 ## Comments are marked like this. The rest of the file is INI-style. The
   4 ## comments should tell you enough about what all settings mean.
   5 ##
   6
   7 [settings]
   8
   9 ## RunMode:
  10 ##
  11 ##  Inetd -- Run from inetd (default)
  12 ##  Daemon -- Run as a stand-alone daemon, serving all users from one process.
  13 ##    This saves memory if there are more users, the downside is that when one
  14 ##    user hits a crash-bug, all other users will also lose their connection.
  15 ##  ForkDaemon -- Run as a stand-alone daemon, but keep all clients in separate
  16 ##    child processes. This should be pretty safe and reliable to use instead
  17 ##    of inetd mode.
  18 ##
  19 # RunMode = Inetd
  20
  21 ## User:
  22 ##
  23 ## If BitlBee is started by root as a daemon, it can drop root privileges,
  24 ## and change to the specified user.
  25 ##
  26 # User = bitlbee
  27
  28 ## DaemonPort/DaemonInterface:
  29 ##
  30 ## For daemon mode, you can specify on what interface and port the daemon
  31 ## should be listening for connections.
  32 ##
  33 # DaemonInterface = 0.0.0.0
  34 # DaemonPort = 6667
  35
  36 ## ClientInterface:
  37 ##
  38 ## If for any reason, you want BitlBee to use a specific address/interface
  39 ## for outgoing traffic (IM connections, HTTP(S), etc.), set it here.
  40 ##
  41 # ClientInterface = 0.0.0.0
  42
  43 ## AuthMode
  44 ##
  45 ##  Open -- Accept connections from anyone, use NickServ for user authentication.
  46 ##    (default)
  47 ##  Closed -- Require authorization (using the PASS command during login) before
  48 ##    allowing the user to connect at all.
  49 ##  Registered -- Only allow registered users to use this server; this disables
  50 ##    the register- and the account command until the user identifies itself.
  51 ##
  52 # AuthMode = Open
  53
  54 ## AuthPassword
  55 ##
  56 ## Password the user should enter when logging into a closed BitlBee server.
  57 ## You can also have a BitlBee-style MD5 hash here. Format: "md5:", followed
  58 ## by a hash as generated by "bitlbee -x hash <password>".
  59 ##
  60 # AuthPassword = ItllBeBitlBee   ## Heh.. Our slogan. ;-)
  61 ## or
  62 # AuthPassword = md5:gzkK0Ox/1xh+1XTsQjXxBJ571Vgl
  63
  64 ## OperPassword
  65 ##
  66 ## Password that unlocks access to special operator commands.
  67 ##
  68 # OperPassword = ChangeMe!
  69 ## or
  70 # OperPassword = md5:I0mnZbn1t4R731zzRdDN2/pK7lRX
  71
  72 ## HostName
  73 ##
  74 ## Normally, BitlBee gets a hostname using getsockname(). If you have a nicer
  75 ## alias for your BitlBee daemon, you can set it here and BitlBee will identify
  76 ## itself with that name instead.
  77 ##
  78 # HostName = localhost
  79
  80 ## MotdFile
  81 ##
  82 ## Specify an alternative MOTD (Message Of The Day) file. Default value depends
  83 ## on the --etcdir argument to configure.
  84 ##
  85 # MotdFile = /etc/bitlbee/motd.txt
  86
  87 ## ConfigDir
  88 ##
  89 ## Specify an alternative directory to store all the per-user configuration
  90 ## files. (.nicks/.accounts)
  91 ##
  92 # ConfigDir = /var/lib/bitlbee
  93
  94 ## Ping settings
  95 ##
  96 ## BitlBee can send PING requests to the client to check whether it's still
  97 ## alive. This is not very useful on local servers, but it does make sense
  98 ## when most clients connect to the server over a real network interface.
  99 ## (Public servers) Pinging the client will make sure lost clients are
 100 ## detected and cleaned up sooner.
 101 ##
 102 ## PING requests are sent every PingInterval seconds. If no PONG reply has
 103 ## been received for PingTimeOut seconds, BitlBee aborts the connection.
 104 ##
 105 ## To disable the pinging, set at least one of these to 0.
 106 ##
 107 # PingInterval = 180
 108 # PingTimeOut = 300
 109
 110 ## Using proxy servers for outgoing connections
 111 ##
 112 ## If you're running BitlBee on a host which is behind a restrictive firewall
 113 ## and a proxy server, you can tell BitlBee to use that proxy server here.
 114 ## The setting has to be a URL, formatted like one of these examples:
 115 ##
 116 ## (Obviously, the username and password are optional)
 117 ##
 118 # Proxy = http://john:doe@proxy.localnet.com:8080
 119 # Proxy = socks4://socksproxy.localnet.com
 120 # Proxy = socks5://socksproxy.localnet.com
 121
 122 ## Protocols offered by bitlbee
 123 ##
 124 ## As recompiling may be quite unpractical for some people, this option
 125 ## allows to remove the support of protocol, even if compiled in. If
 126 ## nothing is given, there are no restrictions.
 127 ##
 128 # Protocols = jabber yahoo
 129
 130 ## Trusted CAs
 131 ##
 132 ## Path to a file containing a list of trusted certificate authorities used in
 133 ## the verification of server certificates.
 134 ##
 135 ## Uncomment this and make sure the file actually exists and contains all
 136 ## certificate authorities you're willing to accept (default value should
 137 ## work on at least Debian/Ubuntu systems with the "ca-certificates" package
 138 ## installed). As long as the line is commented out, SSL certificate
 139 ## verification is completely disabled.
 140 ##
 141 ## The location of this file may be different on other distros/OSes. For
 142 ## example, try /etc/ssl/ca-bundle.pem on OpenSUSE.
 143 ##
 144 # CAfile = /etc/ssl/certs/ca-certificates.crt
 145
 146 [defaults]
 147
 148 ## Here you can override the defaults for some per-user settings. Users are
 149 ## still able to override your defaults, so this is not a way to restrict
 150 ## your users...
 151
 152 ## To enable private mode by default, for example:
 153
 154 ## private = 1