DISPATCHER Module

Publisher

Kamailio project

URL

https://www.kamailio.org/docs/modules/stable/modules/dispatcher.html

Published

unknown

Updated

unknown

Accessed

2026-09-24

HTTP status

200

License

GPL-2.0 project documentation; not confirmed on page; no-redistribution; short excerpts and locators only

Source notes citing this source

• Dispatcher algorithm numbers are not portable between Kamailio and OpenSIPS: for example, algorithm 8 is priority-ordered serial forking in Kamailio but first entry in the set in OpenSIPS, and algorithm 10 is call load distribution in Kamailio but an algo_route callback in OpenSIPS. inferred in context
• The Kamailio dispatcher module offers algorithms 0 to 14 plus 64, including 0 Call-ID hash, 4 round-robin, 8 priority-ordered serial forking, 9 weight-based, 10 call load distribution, 11 relative weight with congestion control, 12 parallel forking to all destinations, 13 latency-optimized and 64 round-robin with overload control. in context
• In the Kamailio dispatcher, flag 2 of the flags parameter enables failover: the remaining destinations are stored so that ds_next_dst() can try the next one after a failure. in context
• Kamailio dispatcher ds_ping_interval sets how often a request is sent to gateways marked inactive, and setting it to 0 disables gateway pinging. in context
• Kamailio dispatcher ds_probing_mode 1 probes all gateways continuously and moves failed active gateways to the trying state, while mode 0 probes only gateways flagged for probing. in context
• In Kamailio, ds_select_dst() puts the chosen destination in the destination URI (outbound proxy), so it is not visible in the SIP request, while ds_select_domain() rewrites the host and port of the request URI. in context
• The dispatcher module's ds_ping_interval defaults to 0, and at 0 pinging of inactive gateways is disabled, so an operator has to set it for OPTIONS probing to run. in context
• The Kamailio dispatcher module's ds_ping_method parameter, the SIP method used to probe destinations, defaults to OPTIONS. in context
• ds_probing_mode decides which dispatcher destinations get probed: 0 probes only destinations in PROBING state, 1 probes all, 2 probes only INACTIVE destinations with PROBING set, and 3 keeps probing PROBING destinations without changing their PROBING state. in context
• By default the dispatcher module counts only 200 OK to a probe as success. The ds_ping_reply_codes parameter can add other codes. in context
• By default the dispatcher module marks a destination inactive after the first failed probe (ds_probing_threshold = 1) and active again after the first successful one (ds_inactive_threshold = 1). in context

Cite this source record

APA

WarmTransfer. (2026, September 24). DISPATCHER Module. WarmTransfer. https://warmtransfer.net/knowledge/sources/kamailio-docs-stable-dispatcher

BibTeX

@misc{warmtransfer-kamailio-docs-stable-dispatcher,
  title  = {DISPATCHER Module},
  author = {{WarmTransfer}},
  year   = {2026},
  url    = {https://warmtransfer.net/knowledge/sources/kamailio-docs-stable-dispatcher},
  note   = {Kamailio project, accessed 2026-09-24}
}