---
name: "opensipsctl"
section: "8"
platform: "linux"
package: "opensips"
version: "2.2.2-3"
release: "Debian 9 (Stretch)"
platforms: ["linux"]
url: "https://new.carta.tech/opensipsctl"
---

# opensipsctl(8)

opensips control tool

## NAME

opensipsctl - opensips control tool

## SYNOPSIS

**opensipsctl** **command** \[ **parameters** \]

## DESCRIPTION

**opensipsctl** is a shell script to control **OpenSIPS SIP server** It can be used to manage users, domains, aliases and other server options

## FILES

*/etc/opensips/.opensipsctlrc*\
 */usr/local/etc/opensips/.opensipsctlrc*\
 *~/.opensipsctlrc*\

## COMMANDS

- **-h**

  Displays a short usage description, including all available options.

- **moni**

  show internal status

- **ps**

  show running processes

- **fifo**

  send raw FIFO commands

- **ping \<uri\>**

  ping a URI (OPTIONS)

- **cisco\_restart \<uri\>**

  restart a Cisco phone (NOTIFY)

- *SUBSCRIBER management:*

  - **add \<username\> \<password\>**

  add a new subscriber (\*)

- **passwd \<username\> \<passwd\>**

  change user's password (\*)

- **rm \<username\>**

  delete a user (\*)

- **alias show \[\<alias\>\]**

  show aliases

- **alias rm \<alias\>**

  remove an alias

- **alias add \<alias\> \<uri\>**

  add an aliases

- **rpid add \<username\> \<rpid\>**

  add rpid for a user (\*)

- **rpid rm \<username\>**

  set rpid to NULL for a user (\*)

- **rpid show \<username\>**

  show rpid of a user

- **alias\_db show \<alias\>**

  show alias details

- **alias\_db list \<sip-id\>**

  list aliases for uri

- **alias\_db add \<alias\> \<sip-id\>**

  add an alias (\*)

- **alias\_db rm \<alias\>**

  remove an alias (\*)

- **alias\_db help**

  help message

- **dispatcher show**

  show dispatcher gateways

- **dispatcher reload**

  reload dispatcher gateways

- **dispatcher dump**

  show in memory dispatcher gateways

- **dispatcher addgw \<setid\> \<destination\> \<socket\> \<flags\> \<weight\> \<attrs\> \[description\]**

  add gateway

- **dispatcher rmgw \<id\>**

  delete gateway

- **speeddial show \<speeddial-id\>**

  show speeddial details

- **speeddial list \<sip-id\>**

  list speeddial for uri

- **speeddial add \<sip-id\> \<sd-id\> \<new-uri\> \[\<desc\>\]**

  add a speedial (\*)

- **speeddial rm \<sip-id\> \<sd-id\>**

  remove a speeddial (\*)

- **speeddial help**

  help message

- *AVP management:*

  - **avp list \[-T table\] \[-u \<sip-id\|uuid\>\] \[-a attribute\] \[-v value\] \[-t type\]**

  list AVPs

- **avp add \[-T table\] \<sip-id\|uuid\> \<attribute\> \<type\> \<value\>**

  add AVP (\*)

- **avp rm \[-T table\] \[-u \<sip-id\|uuid\>\] \[-a attribute\] \[-v value\] \[-t type\]**

  remove AVP (\*)

- **avp help**

  help message

- *ACL (Access Control Lists) management*

  - **acl show \[\<username\>\]**

  show user membership

- **acl grant \<username\> \<group\>**

  grant user membership (\*)

- **acl revoke \<username\> \[\<group\>\]**

  grant user membership(s) (\*)

- *USRLOC (User Location) management*

  - **ul show \[\<username\>\]**

  show in-RAM online users

- **ul rm \<username\> \[\<contact URI\>\]**

  delete user's UsrLoc entries

- **ul add \<username\> \<uri\>**

  introduce a permanent UrLoc entry

- **ul add \<username\> \<uri\> \<expires\>**

  introduce a temporary UrLoc entry

- **showdb \[\<username\>\]**

  show online users flushed in DB

- *DOMAIN management*

  - **domain show**

  show list of served domains

- **domain add \<domainname\>**

  add a new served domain

- **domain rm \<domainname\>**

  remove a served domain

## NOTES

Commands labeled with (\*) will prompt for a MySQL password. If the environment variable PW is set, the password will not be prompted.

IP addresses must be entered in dotted quad format e.g. 1.2.3.4

## AUTHORS

see  **/usr/share/doc/opensipsAUTHORS**

## SEE ALSO

**[opensips(8)](/opensips/8.md),**[opensips.cfg(5)](/opensips.cfg/5.md)

Full documentation on opensips is available at *http://www.opensips.org/.*

Mailing lists:

```
users@opensips.org - opensips user community
devel@opensips.org - opensips development, new features and unstable version
```