ejabberd.cfg

   1 %%%
   2 %%%     Debian ejabberd configuration file
   3 %%%     This config must be in UTF-8 encoding
   4 %%%
   5 %%% The parameters used in this configuration file are explained in more detail
   6 %%% in the ejabberd Installation and Operation Guide.
   7 %%% Please consult the Guide in case of doubts, it is available at
   8 %%% /usr/share/doc/ejabberd/guide.html
   9
  10 %%% This configuration file contains Erlang terms.
  11 %%% In case you want to understand the syntax, here are the concepts:
  12 %%%
  13 %%%  - The character to comment a line is %
  14 %%%
  15 %%%  - Each term ends in a dot, for example:
  16 %%%      override_global.
  17 %%%
  18 %%%  - A tuple has a fixed definition, its elements are
  19 %%%    enclosed in {}, and separated with commas:
  20 %%%      {loglevel, 4}.
  21 %%%
  22 %%%  - A list can have as many elements as you want,
  23 %%%    and is enclosed in [], for example:
  24 %%%      [http_poll, web_admin, tls]
  25 %%%
  26 %%%  - A keyword of ejabberd is a word in lowercase.
  27 %%%    The strings are enclosed in "" and can have spaces, dots...
  28 %%%      {language, "en"}.
  29 %%%      {ldap_rootdn, "dc=example,dc=com"}.
  30 %%%
  31 %%%  - This term includes a tuple, a keyword, a list and two strings:
  32 %%%      {hosts, ["jabber.example.net", "im.example.com"]}.
  33 %%%
  34
  35 %%%   ===================================
  36 %%%   OVERRIDE OPTIONS STORED IN DATABASE
  37
  38 %%
  39 %% Override global options (shared by all ejabberd nodes in a cluster).
  40 %%
  41 %%override_global.
  42
  43 %%
  44 %% Override local options (specific for this particular ejabberd node).
  45 %%
  46 %%override_local.
  47
  48 %%
  49 %% Remove the Access Control Lists before new ones are added.
  50 %%
  51 %%override_acls.
  52
  53
  54 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  55 %% Options which are set by Debconf and managed by ucf
  56
  57 %% Admin user
  58 {acl, admin, {user, "", "localhost"}}.
  59
  60 %% Hostname
  61 {hosts, ["dehnerts.com"]}.
  62
  63 %%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
  64
  65
  66 %%%   =========
  67 %%%   DEBUGGING
  68
  69 %%
  70 %% loglevel: Verbosity of log files generated by ejabberd.
  71 %% 0: No ejabberd log at all (not recommended)
  72 %% 1: Critical
  73 %% 2: Error
  74 %% 3: Warning
  75 %% 4: Info
  76 %% 5: Debug
  77 %%
  78 {loglevel, 4}.
  79
  80 %%
  81 %% watchdog_admins: If an ejabberd process consumes too much memory,
  82 %% send live notifications to those Jabber accounts.
  83 %%
  84 %%{watchdog_admins, ["bob@example.com"]}.
  85
  86
  87 %%%   ================
  88 %%%   SERVED HOSTNAMES
  89
  90 %%
  91 %% hosts: Domains served by ejabberd.
  92 %% You can define one or several, for example:
  93 %% {hosts, ["example.net", "example.com", "example.org"]}.
  94 %%
  95 %% (This option is defined by debconf earlier)
  96 %% {hosts, ["localhost"]}.
  97
  98 %%
  99 %% route_subdomains: Delegate subdomains to other Jabber server.
 100 %% For example, if this ejabberd serves example.org and you want
 101 %% to allow communication with a Jabber server called im.example.org.
 102 %%
 103 %%{route_subdomains, s2s}.
 104
 105
 106 %%%   ===============
 107 %%%   LISTENING PORTS
 108
 109 %%
 110 %% listen: Which ports will ejabberd listen, which service handles it
 111 %% and what options to start it with.
 112 %%
 113 {listen,
 114  [
 115   {5222, ejabberd_c2s, [
 116                         {access, c2s},
 117                         {shaper, c2s_shaper},
 118                         {max_stanza_size, 65536},
 119                         %%zlib,
 120                         starttls, {certfile, "/etc/ejabberd/ejabberd.pem"}
 121                        ]},
 122
 123   %%
 124   %% To enable the old SSL connection method (deprecated) in port 5223:
 125   %%
 126   %%{5223, ejabberd_c2s, [
 127   %%                    {access, c2s},
 128   %%                    {shaper, c2s_shaper},
 129   %%                    {max_stanza_size, 65536},
 130   %%                    zlib,
 131   %%                    tls, {certfile, "/etc/ejabberd/ejabberd.pem"}
 132   %%                   ]},
 133
 134   {5269, ejabberd_s2s_in, [
 135                            {shaper, s2s_shaper},
 136                            {max_stanza_size, 131072}
 137                           ]},
 138
 139   %% External MUC jabber-muc
 140   %%{5554, ejabberd_service, [
 141   %%                        {ip, {127, 0, 0, 1}},
 142   %%                        {access, all},
 143   %%                        {shaper_rule, fast},
 144   %%                        {host, "muc.localhost", [{password, "secret"}]}
 145   %%                        ]},
 146
 147   %% Jabber ICQ Transport
 148   %%{5555, ejabberd_service, [
 149   %%                        {ip, {127, 0, 0, 1}},
 150   %%                        {access, all},
 151   %%                        {shaper_rule, fast},
 152   %%                        {hosts, ["icq.localhost", "sms.localhost"],
 153   %%                                   [{password, "secret"}]}
 154   %%                        ]},
 155
 156   %% AIM Transport
 157   %%{5556, ejabberd_service, [
 158   %%                        {ip, {127, 0, 0, 1}},
 159   %%                        {access, all},
 160   %%                        {shaper_rule, fast},
 161   %%                        {host, "aim.localhost", [{password, "secret"}]}
 162   %%                        ]},
 163
 164   %% MSN Transport
 165   %%{5557, ejabberd_service, [
 166   %%                        {ip, {127, 0, 0, 1}},
 167   %%                        {access, all},
 168   %%                        {shaper_rule, fast},
 169   %%                        {host, "msn.localhost", [{password, "secret"}]}
 170   %%                        ]},
 171
 172   %% Yahoo! Transport
 173   %%{5558, ejabberd_service, [
 174   %%                        {ip, {127, 0, 0, 1}},
 175   %%                        {access, all},
 176   %%                        {shaper_rule, fast},
 177   %%                        {host, "yahoo.localhost", [{password, "secret"}]}
 178   %%                        ]},
 179
 180   %% External JUD (internal is more powerful,
 181   %% but doesn't allow to register users from other servers)
 182   %%{5559, ejabberd_service, [
 183   %%                        {ip, {127, 0, 0, 1}},
 184   %%                        {access, all},
 185   %%                        {shaper_rule, fast},
 186   %%                        {host, "jud.localhost", [{password, "secret"}]}
 187   %%                        ]},
 188
 189   {5280, ejabberd_http, [
 190                          %%{request_handlers,
 191                          %% [
 192                          %%  {["pub", "archive"], mod_http_fileserver}
 193                          %% ]},
 194                          %%captcha,
 195                          http_bind,
 196                          http_poll,
 197                          web_admin
 198                         ]}
 199
 200  ]}.
 201
 202 %%
 203 %% s2s_use_starttls: Enable STARTTLS + Dialback for S2S connections.
 204 %% Allowed values are: true or false.
 205 %% You must specify a certificate file.
 206 %%
 207 {s2s_use_starttls, true}.
 208
 209 %%
 210 %% s2s_certfile: Specify a certificate file.
 211 %%
 212 {s2s_certfile, "/etc/ejabberd/ejabberd.pem"}.
 213
 214 %%
 215 %% domain_certfile: Specify a different certificate for each served hostname.
 216 %%
 217 %%{domain_certfile, "example.org", "/path/to/example_org.pem"}.
 218 %%{domain_certfile, "example.com", "/path/to/example_com.pem"}.
 219
 220 %%
 221 %% S2S whitelist or blacklist
 222 %%
 223 %% Default s2s policy for undefined hosts.
 224 %%
 225 %%{s2s_default_policy, allow}.
 226
 227 %%
 228 %% Allow or deny communication with specific servers.
 229 %%
 230 %%{{s2s_host, "goodhost.org"}, allow}.
 231 %%{{s2s_host, "badhost.org"}, deny}.
 232
 233 %%
 234 %% The maximum allowed delay for retry to connect
 235 %% after a failed connection attempt to a remote server, in seconds.
 236 %% The default value is 300 seconds (5 minutes).
 237 %%
 238 %% The reconnection algorythm works like this: if connection fails,
 239 %% ejabberd makes an initial random delay between 1 and 15 seconds,
 240 %% then retries, and if this attempt fails, makes another delay,
 241 %% twice as long as previous. These attempts are performed either
 242 %% until a successful connection is made or until the next calculated
 243 %% delay is greated or equal than the value of s2s_max_retry_delay.
 244 %%
 245 %%{s2s_max_retry_delay, 300}.
 246
 247 %%
 248 %% Outgoing S2S options
 249 %%
 250 %% Preferred address families (which to try first) and connect timeout
 251 %% in milliseconds.
 252 %%
 253 %%{outgoing_s2s_options, [ipv4, ipv6], 10000}.
 254
 255
 256 %%%   ==============
 257 %%%   AUTHENTICATION
 258
 259 %%
 260 %% auth_method: Method used to authenticate the users.
 261 %% The default method is the internal.
 262 %% If you want to use a different method,
 263 %% comment this line and enable the correct ones.
 264 %%
 265 {auth_method, internal}.
 266
 267 %%
 268 %% Authentication using external script
 269 %% Make sure the script is executable by ejabberd.
 270 %%
 271 %%{auth_method, external}.
 272 %%{extauth_program, "/path/to/authentication/script"}.
 273
 274 %%
 275 %% Authentication using ODBC
 276 %% Remember to setup a database in the next section.
 277 %%
 278 %%{auth_method, odbc}.
 279
 280 %%
 281 %% Authentication using PAM
 282 %%
 283 %%{auth_method, pam}.
 284 %%{pam_service, "pamservicename"}.
 285
 286 %%
 287 %% Authentication using LDAP
 288 %%
 289 %%{auth_method, ldap}.
 290 %%
 291 %% List of LDAP servers:
 292 %%{ldap_servers, ["localhost"]}.
 293 %%
 294 %% Encryption of connection to LDAP servers (LDAPS):
 295 %%{ldap_encrypt, none}.
 296 %%{ldap_encrypt, tls}.
 297 %%
 298 %% Port connect to LDAP server:
 299 %%{ldap_port, 389}.
 300 %%{ldap_port, 636}.
 301 %%
 302 %% LDAP manager:
 303 %%{ldap_rootdn, "dc=example,dc=com"}.
 304 %%
 305 %% Password to LDAP manager:
 306 %%{ldap_password, "******"}.
 307 %%
 308 %% Search base of LDAP directory:
 309 %%{ldap_base, "dc=example,dc=com"}.
 310 %%
 311 %% LDAP attribute that holds user ID:
 312 %%{ldap_uids, [{"mail", "%u@mail.example.org"}]}.
 313 %%
 314 %% LDAP filter:
 315 %%{ldap_filter, "(objectClass=shadowAccount)"}.
 316
 317 %%
 318 %% Anonymous login support:
 319 %%   auth_method: anonymous
 320 %%   anonymous_protocol: sasl_anon | login_anon | both
 321 %%   allow_multiple_connections: true | false
 322 %%
 323 %%{host_config, "public.example.org", [{auth_method, anonymous},
 324 %%                                     {allow_multiple_connections, false},
 325 %%                                     {anonymous_protocol, sasl_anon}]}.
 326 %%
 327 %% To use both anonymous and internal authentication:
 328 %%
 329 %%{host_config, "public.example.org", [{auth_method, [internal, anonymous]}]}.
 330
 331
 332 %%%   ==============
 333 %%%   DATABASE SETUP
 334
 335 %% ejabberd uses by default the internal Mnesia database,
 336 %% so you can avoid this section.
 337 %% This section provides configuration examples in case
 338 %% you want to use other database backends.
 339 %% Please consult the ejabberd Guide for details about database creation.
 340
 341 %% NOTE that ejabberd in Debian supports "out of the box"
 342 %% only mnesia (default) and ODBC storage backends.
 343 %% Working with MySQL and PostgreSQL DB backends requires
 344 %% building and installation of the corresponding Erlang modules,
 345 %% not distributed as a part of ejabberd.
 346 %% Refer to /usr/share/doc/ejabberd/README.Debian for details.
 347
 348 %%
 349 %% MySQL server:
 350 %%
 351 %%{odbc_server, {mysql, "server", "database", "username", "password"}}.
 352 %%
 353 %% If you want to specify the port:
 354 %%{odbc_server, {mysql, "server", 1234, "database", "username", "password"}}.
 355
 356 %%
 357 %% PostgreSQL server:
 358 %%
 359 %%{odbc_server, {pgsql, "server", "database", "username", "password"}}.
 360 %%
 361 %% If you want to specify the port:
 362 %%{odbc_server, {pgsql, "server", 1234, "database", "username", "password"}}.
 363 %%
 364 %% If you use PostgreSQL, have a large database, and need a
 365 %% faster but inexact replacement for "select count(*) from users"
 366 %%
 367 %%{pgsql_users_number_estimate, true}.
 368
 369 %%
 370 %% ODBC compatible or MSSQL server:
 371 %%
 372 %%{odbc_server, "DSN=ejabberd;UID=ejabberd;PWD=ejabberd"}.
 373
 374 %%
 375 %% Number of connections to open to the database for each virtual host
 376 %%
 377 %%{odbc_pool_size, 10}.
 378
 379 %%
 380 %% Interval to make a dummy SQL request to keep alive the connections
 381 %% to the database. Specify in seconds: for example 28800 means 8 hours
 382 %%
 383 %%{odbc_keepalive_interval, undefined}.
 384
 385
 386 %%%   ===============
 387 %%%   TRAFFIC SHAPERS
 388
 389 %%
 390 %% The "normal" shaper limits traffic speed to 1.000 B/s
 391 %%
 392 {shaper, normal, {maxrate, 1000}}.
 393
 394 %%
 395 %% The "fast" shaper limits traffic speed to 50.000 B/s
 396 %%
 397 {shaper, fast, {maxrate, 50000}}.
 398
 399
 400 %%%   ====================
 401 %%%   ACCESS CONTROL LISTS
 402
 403 %%
 404 %% The 'admin' ACL grants administrative privileges to Jabber accounts.
 405 %% You can put as many accounts as you want.
 406 %%
 407 %%{acl, admin, {user, "aleksey", "localhost"}}.
 408 {acl, admin, {user, "alex-admin" }}.
 409 {acl, admin, {user, "alex-admin@dehnerts.com" }}.
 410 {acl, admin, {user, "alex-admin@jabber.dehnerts.com" }}.
 411 %%{acl, admin, {user, "ermine", "example.org"}}.
 412
 413 %%
 414 %% Blocked users
 415 %%
 416 %%{acl, blocked, {user, "baduser", "example.org"}}.
 417 %%{acl, blocked, {user, "test"}}.
 418
 419 %%
 420 %% Local users: don't modify this line.
 421 %%
 422 {acl, local, {user_regexp, ""}}.
 423
 424 %%
 425 %% More examples of ACLs
 426 %%
 427 %%{acl, jabberorg, {server, "jabber.org"}}.
 428 %%{acl, aleksey, {user, "aleksey", "jabber.ru"}}.
 429 %%{acl, test, {user_regexp, "^test"}}.
 430 %%{acl, test, {user_glob, "test*"}}.
 431
 432 %%
 433 %% Define specific ACLs in a virtual host.
 434 %%
 435 %%{host_config, "localhost",
 436 %% [
 437 %%  {acl, admin, {user, "bob-local", "localhost"}}
 438 %% ]
 439 %%}.
 440
 441
 442 %%%   ============
 443 %%%   ACCESS RULES
 444
 445 %% Define the maximum number of time a single user is allowed to connect:
 446 {access, max_user_sessions, [{10, all}]}.
 447
 448 %% Maximum number of offline messages that users can have:
 449 {access, max_user_offline_messages, [{5000, admin}, {100, all}]}.
 450
 451 %% This rule allows access only for local users:
 452 {access, local, [{allow, local}]}.
 453
 454 %% Only non-blocked users can use c2s connections:
 455 {access, c2s, [{deny, blocked},
 456                {allow, all}]}.
 457
 458 %% For all users except admins used "normal" shaper
 459 {access, c2s_shaper, [{none, admin},
 460                       {normal, all}]}.
 461
 462 %% For all S2S connections used "fast" shaper
 463 {access, s2s_shaper, [{fast, all}]}.
 464
 465 %% Only admins can send announcement messages:
 466 {access, announce, [{allow, admin}]}.
 467
 468 %% Only admins can use configuration interface:
 469 {access, configure, [{allow, admin}]}.
 470
 471 %% Admins of this server are also admins of MUC service:
 472 {access, muc_admin, [{allow, admin}]}.
 473
 474 %% All users are allowed to use MUC service:
 475 {access, muc, [{allow, all}]}.
 476
 477 %% No username can be registered via in-band registration:
 478 %% To enable in-band registration, replace 'deny' with 'allow'
 479 % (note that if you remove mod_register from modules list then users will not
 480 % be able to change their password as well as register).
 481 % This setting is default because it's more safe.
 482 {access, register, [{deny, all}]}.
 483
 484 %% By default frequency of account registrations from the same IP
 485 %% is limited to 1 account every 10 minutes. To disable put: infinity
 486 %%{registration_timeout, 600}.
 487
 488 %% Everybody can create pubsub nodes
 489 {access, pubsub_createnode, [{allow, all}]}.
 490
 491 %%
 492 %% Define specific Access rules in a virtual host.
 493 %%
 494 %%{host_config, "localhost",
 495 %% [
 496 %%  {access, c2s, [{allow, admin}, {deny, all}]},
 497 %%  {access, register, [{deny, all}]}
 498 %% ]
 499 %%}.
 500
 501
 502 %%%   ================
 503 %%%   DEFAULT LANGUAGE
 504
 505 %%
 506 %% language: Default language used for server messages.
 507 %%
 508 {language, "en"}.
 509
 510 %%
 511 %% Set a different default language in a virtual host.
 512 %%
 513 %%{host_config, "localhost",
 514 %% [{language, "ru"}]
 515 %%}.
 516
 517
 518 %%%   =======
 519 %%%   CAPTCHA
 520
 521 %%
 522 %% Full path to a script that generates the image.
 523 %% Note that this script must be made executable
 524 %% for the user ejabberd:ejabberd.
 525 %%
 526 %%{captcha_cmd, "/usr/lib/ejabberd/priv/bin/captcha.sh"}.
 527
 528 %%
 529 %% Host part of the URL sent to the user.
 530 %% The port specified must be configured as the "ejabberd_http"
 531 %% listener which must have the "captcha" directive included
 532 %% in its configuration (see the "LISTENING PORTS" section above).
 533 %%
 534 %%{captcha_host, "localhost:5280"}.
 535
 536
 537 %%%   =======
 538 %%%   MODULES
 539
 540 %%
 541 %% Modules enabled in all ejabberd virtual hosts.
 542 %%
 543 {modules,
 544  [
 545   {mod_adhoc,    []},
 546   {mod_announce, [{access, announce}]}, % requires mod_adhoc
 547   {mod_caps,     []},
 548   {mod_configure,[]}, % requires mod_adhoc
 549   {mod_admin_extra, []},
 550   {mod_disco,    []},
 551   %%{mod_echo,   [{host, "echo.localhost"}]},
 552   {mod_irc,      []},
 553   %% NOTE that mod_http_fileserver must also be enabled in the
 554   %% "request_handlers" clause of the "ejabberd_http" listener
 555   %% configuration (see the "LISTENING PORTS" section above).
 556   %%{mod_http_fileserver, [
 557   %%                       {docroot, "/var/www"},
 558   %%                       {accesslog, "/var/log/ejabberd/access.log"}
 559   %%                      ]},
 560   {mod_last,     []},
 561   {mod_muc,      [
 562                   %%{host, "conference.@HOST@"},
 563                   {access, muc},
 564                   {access_create, muc},
 565                   {access_persistent, muc},
 566                   {access_admin, muc_admin},
 567                   {max_users, 500}
 568                  ]},
 569   %%{mod_muc_log,[]},
 570   {mod_offline,  [{access_max_user_messages, max_user_offline_messages}]},
 571   {mod_privacy,  []},
 572   {mod_private,  []},
 573   {mod_proxy65,  [
 574                   {access, local},
 575                   {shaper, c2s_shaper}
 576                  ]},
 577   {mod_pubsub,   [ % requires mod_caps
 578                   {access_createnode, pubsub_createnode},
 579                   {pep_sendlast_offline, false},
 580                   {last_item_cache, false},
 581                   %%{plugins, ["default", "pep"]}
 582                   {plugins, ["flat", "hometree", "pep"]}  % pep requires mod_caps
 583                  ]},
 584   {mod_register, [
 585                   %%
 586                   %% After successful registration, the user receives
 587                   %% a message with this subject and body.
 588                   %%
 589                   {welcome_message, {"Welcome!",
 590                                      "Welcome to a Jabber service powered by Debian. "
 591                                      "For information about Jabber visit "
 592                                      "http://www.jabber.org"}},
 593                   %% Replace it with 'none' if you don't want to send such message:
 594                   %%{welcome_message, none},
 595
 596                   %%
 597                   %% When a user registers, send a notification to
 598                   %% these Jabber accounts.
 599                   %%
 600                   %%{registration_watchers, ["admin1@example.org"]},
 601
 602                   {access, register}
 603                  ]},
 604   {mod_roster,   []},
 605   %%{mod_service_log,[]},
 606   %%{mod_shared_roster,[]},
 607   {mod_stats,    []},
 608   {mod_time,     []},
 609   {mod_vcard,    []},
 610   {mod_version,  []}
 611  ]}.
 612
 613 %%
 614 %% Enable modules with custom options in a specific virtual host
 615 %%
 616 %%{host_config, "localhost",
 617 %% [{{add, modules},
 618 %%   [
 619 %%    {mod_echo, [{host, "mirror.localhost"}]}
 620 %%   ]
 621 %%  }
 622 %% ]}.
 623
 624
 625 %%% $Id: ejabberd.cfg.example 2497 2009-08-17 20:27:28Z cromain $
 626
 627 %%% Local Variables:
 628 %%% mode: erlang
 629 %%% End:
 630 %%% vim: set filetype=erlang tabstop=8: