Compatibility Matrix
This page documents, for each version of the S-Filer Portal server, the versions of the other S-Filer components and of the external dependencies that are compatible with it. Use it before an installation or an upgrade to make sure every piece of your deployment lines up with the server version you are running.
Note
This matrix applies to on-premises (self-hosted) deployments. It does not apply to SaaS clients, whose instances are installed and managed by OKIOK.
The grid is indexed by server version and lists minor versions only (for example 4.19.x, 4.20.x). Corrective (patch) releases within a minor version are not detailed individually.
Important
The Gateway and the CLI must be at exactly the same version as the server. Mixing a Gateway or CLI from a different minor version than the server is not supported.
S-Filer components
Each row is a server minor version. The DB schema column lists the database schema version(s) the server can run against, the Gateway and CLI columns give the required version of those components, and the CLI — minimum Java column gives the minimum version of the external Java runtime the CLI must be launched with — later Java versions are also supported (see CLI and Java below).
| Server version | Compatible DB schema | Gateway | CLI | CLI — minimum Java |
|---|---|---|---|---|
4.11.x | 4.11.x | 4.11.x | 4.11.x | Java 8 |
4.12.x | 4.12.x | 4.12.x | 4.12.x | Java 8 |
4.13.x | 4.13.x | 4.13.x | 4.13.x | Java 8 |
4.14.x | 4.14.x | 4.14.x | 4.14.x | Java 8 |
4.15.x | 4.15.x | 4.15.x | 4.15.x | Java 8 |
4.16.x | 4.16.x | 4.16.x | 4.16.x | Java 8 |
4.17.x | 4.17.x | 4.17.x | 4.17.x | Java 8 |
4.18.x | 4.18.x | 4.18.x | 4.18.x | Java 8 |
4.19.x | 4.19.x | 4.19.x | 4.19.x | Java 17 |
4.20.x | 4.20.x, 4.21.x | 4.20.x | 4.20.x | Java 17 |
4.21.x | 4.21.x | 4.21.x | 4.21.x | Java 25 |
Database schema compatibility rule
- Servers
4.19.xand earlier are compatible only with the database schema of the same version. - Starting with
4.20.x, a server is compatible with its own schema and the schema of the next minor version. In general terms, every version from4.20.xonward supports its own database schema and the schema of one version ahead (for example, a4.20.xserver runs against schema4.20.xor4.21.x). This is what makes a rolling upgrade possible: the schema can be migrated to the next version while servers are still running the current one. - Because
4.21.xis the most recent version covered by this matrix, only its own schema is listed. The same one-version-ahead rule will extend it to the next minor version's schema once that version is released.
See Also
For the behaviour observed when a schema is upgraded ahead of the configuration interface or the config CLI, see Configuration Values Displaying Technical Names.
CLI and Java
The S-Filer CLI runs on a Java runtime that you provide (it is not bundled with its own JVM), so its minimum supported Java version is listed separately from the CLI version itself. The value in the grid is a floor — that version or later is supported:
- Server versions
4.11.xthrough4.18.x— the CLI requires Java 8 or later. - Server versions
4.19.xand4.20.x— the CLI requires Java 17 or later. - Server version
4.21.x— the CLI requires Java 25 or later.
Warning
Running the CLI with a Java version older than the minimum listed for your server version is not supported and may cause the CLI to fail to start. The minimum was raised from Java 8 to Java 17 at version 4.19.x, and again to Java 25 at 4.21.x — make sure the external Java runtime meets the new minimum when you upgrade across these versions.
Supported databases
The database engines below are the supported external database management systems for on-premises deployments.
| Server version | SQL Server | Oracle Database | MySQL | MariaDB |
|---|---|---|---|---|
4.11.x | 2014, 2016, 2017 | Not supported | 5.7, 8.0 | 5.5, 10.0, 10.1, 10.2, 10.3 |
4.12.x | 2016, 2017, 2019 | 19c | 5.7, 8.0 | 5.5, 10.1, 10.2, 10.3, 10.4 |
4.13.x | 2016, 2017, 2019 | 19c | 5.7, 8.0 | 10.1, 10.2, 10.3, 10.4, 10.5 |
4.14.x | 2016, 2017, 2019 | 19c | 8.0 | 10.2, 10.3, 10.4, 10.5 |
4.15.x | 2017, 2019 | 19c | 8.0 | 10.2, 10.3, 10.4, 10.5, 10.6 |
4.16.x | 2017, 2019 | 19c | 8.0 | 10.2, 10.3, 10.4, 10.5, 10.6 |
4.17.x | 2019, 2022 | 19c | 8.0 | 10.3, 10.4, 10.5, 10.6 |
4.18.x | 2019, 2022 | 19c | 8.0 | 10.4, 10.5, 10.6, 10.11 |
4.19.x | 2019, 2022 | 19c, 23ai | 8.0 | 10.4, 10.5, 10.6, 10.11 |
4.20.x | 2019, 2022 | 19c, 23ai | 8.0, 8.4 | 10.5, 10.6, 10.11, 11.4 |
4.21.x | 2022, 2025 | 19c, 23ai | 8.4, 9.7 | 10.11, 11.4, 11.8, 12.3 |