Skip to Content

Flexisip 2.5 to 2.6 migration guide

Last modified by François Grisez on 2026/06/17 11:51
Contents

Starting with Flexisip 2.6.0, the Flexisip Conference Server has been separated into its own RPM/DEB package. This means that if you need to run the conference service, you must explicitly install the conference server package.

We have automated as much of the migration process as possible, but some manual steps remain necessary.

Updating Flexisip from 2.5 to 2.6

1. Update the core Flexisip package

Update your existing bc-flexisip package as usual:

Rocky Linux:

(shell)$ sudo dnf update bc-flexisip

Debian / Ubuntu:

(shell)$ sudo apt update && sudo apt upgrade bc-flexisip
Warning

After updating the core Flexisip package, any running conference server service will be stopped and uninstalled. At this point, consider your conference service in maintenance mode.

2. Install the conference server package

Install the new package that contains the conference server:

Rocky Linux:

(shell)$ sudo dnf install bc-flexisip-conference

Debian / Ubuntu:

(shell)$ sudo apt install bc-flexisip-conference

3. Verify migration of configuration and persistent data

The new flexisip-conference service uses a separate configuration file from the core Flexisip configuration (/etc/flexisip/flexisip.conf).

During installation, the package automatically migrates your existing conference-related settings to:

/etc/opt/belledonne-communications/flexisip-conference/flexisip-conference.conf

What to check:

  1. Ensure that all parameters from the following sections in /etc/flexisip/flexisip.conf:
    • [global]
    • [conference-server]
    • [module::Registrar]
      are also present in /etc/opt/belledonne-communications/flexisip-conference/flexisip-conference.conf.
  2. Confirm that the UUID file has been migrated correctly:
/var/opt/belledonne-communications/flexisip-conference/lib/uuid

It should contain the exact same string as:

/var/opt/belledonne-communications/lib/flexisip/uuid

4. Enable and start the conference service

(bash)$ sudo systemctl enable --now flexisip-conference

5. Verify the service is running

(bash)$ sudo systemctl status flexisip-conference

Roll-back

If you encounter trouble while or after installation, you can roll-back by following these steps:

1. Removing bc-flexisip-conference package

Rocky Linux:

sudo dnf remove bc-flexisip-conference

Debian / Ubuntu:

(shell)$ sudo apt remove bc-flexisip-conference

2. Downgrade bc-flexisip to your previous version

Rocky Linux:

(shell)$ sudo dnf downgrade bc-flexisip-2.5.1-1.el9

Debian / Ubuntu:

(shell)$ sudo apt install bc-flexisip=2.5.1

3. Enable the flexisip-conference.service

(shell)$ sudo systemctl enable --now flexisip-conference

New file location

The bc-flexisip-conference package follows the Filesystem Hierarchy Standard, using belledonne-communications/flexisip-conference as package name:

Configuration file/etc/opt/belledonne-communications/flexisip-conference/flexisip-conference.conf
Log file/var/opt/belledonne-communications/flexisip-conference/log/flexisip-conference.log
Persistent data directory/var/opt/belledonne-communications/flexisip-conference/lib
Server executable/opt/belledonne-communications/flexisip-conference/bin/flexisip-conference