PJSUA (project page) is an CLI and curses SIP softphone, part of the PJSIP stack. Within Linux, users could use it as a phone to dial numbers right from the command line, i.e. for click-to-call. This docker image support audio, if sound device will be mounted as a docker volume.
But the main goal of this docker image is to let users do manual testing.
Simply run it, there is few scripts:
-
SIP account register and await for calls and user operations:
docker run -ti --rm andrius/pjsua register SIP-ACCOUNT
-
SIP user register and will auto-answer the call:
docker run -ti --rm andrius/pjsua auto-answer SIP-ACCOUNT
-
SIP user register and making a call (SIP invite) to destination:
docker run -ti --rm andrius/pjsua dial SIP-ACCOUNT DESTINATION
It does accept environment variables, easiest way to configure is to use .env
file. Following variables should be set:
-
SIP_SERVER_HOST
- IP address or hostname (name of docker service in docker-compose of the SIP server. Default value is "asterisk"); -
SIP_SERVER_PORT
- SIP port. Default value is "5060"; -
SIP_TRANSPORT
- SIP transport:udp
,tcp
ortls
. Default value is "udp"; -
SIP_PASSWORD
- Password of the SIP account.
Remaining parameter, SIP username should be set as command-line argument of script (listed in the usage section)