/pjsua

SIP user agent (cli) based on PJSUA. Docker version

Primary LanguageShell

SIP user agent (cli) based on PJSUA

Purpose

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.

Usage

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

Configuration

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 or tls. 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)