Upgrading a XiVO PBX is done by executing commands through a terminal on the server. You can connect to the server either through SSH or with a physical console.


To upgrade your XiVO PBX, you have to use both xivo-dist and xivo-upgrade tools. These tools handle the process of upgrading:

  • the system (Debian packages)
  • and the XiVO PBX packages


The following applies to XiVO PBX >= 2016.03. For older version, see Version-specific upgrade procedures section.

There are two cases:

  1. Upgrade to an LTS version of XiVO PBX,
  2. Upgrade to an Intermediate version of XiVO PBX,


Note that it is not possible to downgrade to any version.

Upgrade to an LTS version

To upgrade to a XiVO PBX LTS version you have to update the sources list by using the xivo-dist command:

xivo-dist <XiVO LTS VERSION>

Currently there are two XiVO PBX LTS versions:

  1. (latest) XiVO Polaris (2017.11) - released 2017/10/09:

    xivo-dist xivo-polaris
  2. (old) XiVO Five (2017.03) - released 2017/04/03: see XiVO Five documentation.

Upgrade to an Intermediate version


Intermediate versions have a limited support. You should install LTS version only.

Between XiVO PBX LTS versions we release Intermediate versions (to which is given a limited support). To upgrade to a specific Intermediate version, you have to update the sources to point to this specific version. You have to do it with the xivo-dist command. For example, if you want to upgrade to 2017.06:

xivo-dist xivo-2017.06-latest

Preparing the upgrade

To prepare the upgrade you should:

  1. Read carefully the Release Notes starting from your current version to the version you target.
  2. Check if you are in a specific setup that requires a specific procedure to be followed (e.g. Upgrading a cluster).
  3. Finally, you can download the packages beforehand by running xivo-upgrade -d. This is not mandatory, but it does not require stopping any service, so it may be useful to reduce the downtime of the server while upgrading.



About xivo-upgrade script see:

  1. For custom setups, follow the required procedures described below (e.g. Upgrading a cluster).

  2. When ready, launch the upgrade process. All XiVO PBX services will be stopped during the process:

  3. When finished, check that all services are running (the list is displayed at the end of the upgrade).

  4. Check that services are correctly working like SIP registration, ISDN link status, internal/incoming/outgoing calls, XiVO Client connections etc.

Upgrade Notes

See Release Notes for version specific informations.


See Archived Upgrade Notes for old release notes information.