Skip to main content

PJSIP Provider

Use PJSIP technology for res_pjsip provider trunks. MiRTA PBX maintains related ps_endpoints, ps_aors, ps_auths, and ps_endpoint_id_ips rows when realtime is enabled.

Common Realtime Fields

FieldApplies toPurposeFictional example
Use Realtime AccountSIP, PJSIP, IAX2Creates and maintains the Asterisk realtime peer, endpoint, AOR, auth, or IAX row for the provider.checked
TransportSIP, PJSIPSIP signaling transport. For PJSIP this maps to transport objects such as transport-udp, transport-tcp, or transport-tls.UDP or TLS
RTP Encryption (SRTP)SIP, PJSIPEnables SRTP media encryption when supported by the provider. PJSIP stores this as media_encryption=sdes.No for standard UDP SIP, Yes for TLS/SRTP trunks
HostSIP, PJSIP, IAX2Remote provider address. Use an IP address when inbound realtime matching must identify the carrier by source IP.203.0.113.20
PortSIP, PJSIP, IAX2Remote signaling port. Defaults are commonly 5060 for SIP/PJSIP and 4569 for IAX2.5060
Outbound ProxySIP, PJSIPProxy URI or host used for outbound signaling when required by the carrier.sip-proxy.example.invalid
UsernameSIP, PJSIP, IAX2Authentication username sent to the provider. PJSIP stores this in ps_auths.username, chan_sip as defaultuser.docs_sip_user
PasswordSIP, PJSIP, IAX2Authentication secret for the provider. Use a unique carrier-supplied or generated secret.FictionalSecret-2026
QualifySIP, PJSIPEnables SIP OPTIONS reachability checks and controls timeout behavior.Yes
Qualify FrequencySIP, PJSIPInterval in seconds between provider reachability checks.60 secs
CodecsSIP, PJSIP, IAX2Allowed audio codecs. MiRTA PBX stores disallow=all and the selected allow list.alaw, ulaw, g722
Session ExpiresSIP, PJSIPMaximum SIP session refresh interval in seconds.1800
DTMF ModeSIP, PJSIPDTMF signaling method. PJSIP maps RFC 2833 to rfc4733.RFC 2833/RFC 4733
RTP KeepaliveSIP, PJSIPSends RTP keepalive packets to help keep NAT bindings and media paths active.5 seconds

PJSIP-Specific Fields

FieldApplies toPurposeFictional example
TransportPJSIP onlyMaps to the selected PJSIP transport object. Use TLS when the carrier requires encrypted signaling.TLS
Host and PortPJSIP onlyUsed to build the AOR contact and, when Host is an IP address, the endpoint identify match.198.51.100.30:5061
Username and PasswordPJSIP onlyStored in ps_auths. If username is empty, MiRTA PBX does not attach username/password auth.docs_pjsip_user
Outbound ProxyPJSIP onlyPJSIP outbound proxy string for the endpoint.sip:edge.example.invalid;transport=tls
Send RPIDPJSIP onlyMaps to PJSIP send_rpid and send_pai.PAI
Direct MediaPJSIP onlyAllows PJSIP to attempt direct RTP. Disable when NAT, recording, transcoding, or media control requires Asterisk in the RTP path.No
Allow TransferPJSIP onlyPJSIP allow_transfer. When enabled, the endpoint may request SIP REFER transfers.No
RTP Encryption (SRTP)PJSIP onlyStores media_encryption=sdes when enabled.Yes
Qualify Frequency and TimeoutPJSIP onlyStored on the AOR as qualify_frequency and qualify_timeout.60 secs

Fictional PJSIP Example

Name: Docs Telecom PJSIP Trunk
Peer Name: docs_telecom_pjsip
Technology: PJSIP
Transport: TLS
RTP Encryption: Yes
Host: 198.51.100.30
Port: 5061
Outbound Proxy: sip:edge.example.invalid;transport=tls
Send RPID: PAI
Direct Media: No
Allow Transfer: No