License Portal
Deutsch

Upgrading to LiveConfig v3

Category: LiveConfig
Created: 2026-04-20

Upgrading from LiveConfig 2.x to 3.x is quite simple: install the liveconfig3 (or lcclient3) package — that’s it. The package manager automatically handles the removal of the old package (liveconfig or lcclient), and all data and settings remain unchanged.

The (internal) databases of LiveConfig 2.x and 3.x are fully compatible with each other (based on the latest LiveConfig version in each case). This means switching, for example, from version 2.19.1 to 3.2.0 (and vice versa) is possible at any time. No “migration steps” are required.
In multi-server installations, servers and clients in versions 2.19.0 and 3.2.0 and later are compatible with each other (except for new features, of course). Older clients (< 2.19.0) are largely supported by LiveConfig 3.x (no guarantee of functionality).

Upgrade Requirements:

  • LiveConfig 3.x is available starting with Debian 11 / Ubuntu 22 / RockyLinux 9 / AlmaLinux 9.
  • Server needs to be running with systemd.

Changes incompatible with LiveConfig 2.x:

  • There is no longer a SOAP API – instead, a modern REST API is available.
  • When using the [IFRAME API] (/en/manual/admin/iframe.html), the authentication calls (including those for session verification) must be adjusted accordingly. Sample code and ready-made helper functions are available at https://github.com/LiveConfig/iframe-api.
  • Integrating the login screen into your own website is no longer possible for security reasons (CSP).

Changes from LiveConfig 2.x to 3.x:

  • The web interface is completely new, but the administrative structure (logic) remains largely the same.
  • LiveConfig 3.x now always creates a backup (/var/lib/liveconfig/) during upgrades, even when using MySQL/MariaDB for the internal database.

Recommendations:

  • First, update the standard packages for your distribution (apt update && apt upgrade or yum update).
  • For multi-server installations, it is best to first upgrade the main server to liveconfig3 - once that is successfully completed, install lcclient3 on the remaining servers.
  • If something goes wrong, you can downgrade back to version 2.x at any time by installing the “old” package (liveconfig or lcclient).
  • If you are running LiveConfig behind a reverse proxy, please refer to this article.