Skip to content

Commit 9b831fb

Browse files
committed
Add info about supported OpenSSL versions
1 parent 60c6191 commit 9b831fb

File tree

1 file changed

+8
-3
lines changed

1 file changed

+8
-3
lines changed

doc/tutorials/How-to-build.md

Lines changed: 8 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -20,7 +20,7 @@ To compile MongooseIM you need:
2020
* Erlang/OTP 26.0 or higher:
2121
* `erlang` EPEL package, or,
2222
* install using [kerl](https://github.com/kerl/kerl),
23-
* OpenSSL 0.9.8 or higher, for STARTTLS, SASL and SSL encryption: `openssl` and `openssl-devel`,
23+
* OpenSSL 3.0.2 or higher, for STARTTLS, SASL and SSL encryption: `openssl` and `openssl-devel`,
2424
* ODBC library: `unixODBC-devel`,
2525
* Zlib 1.2.3 or higher: `zlib-devel`.
2626

@@ -31,7 +31,7 @@ To compile MongooseIM you need:
3131
* Erlang/OTP 24.0 or higher:
3232
* `erlang` package, or,
3333
* install using [kerl](https://github.com/kerl/kerl),
34-
* OpenSSL 0.9.8 or higher, for STARTTLS, SASL and SSL encryption: `olibssl-dev`,
34+
* OpenSSL 3.0.2 or higher, for STARTTLS, SASL and SSL encryption: `olibssl-dev`,
3535
* ODBC library: `unixodbc-dev`,
3636
* Zlib 1.2.3 or higher: `zlib1g-dev`.
3737

@@ -41,9 +41,14 @@ To compile MongooseIM you need:
4141
* Erlang/OTP 24.0 or higher:
4242
* [`erlang`](https://formulae.brew.sh/formula/erlang) from Homebrew,
4343
* install using [kerl](https://github.com/kerl/kerl),
44-
* OpenSSL 0.9.8 or higher, for STARTTLS, SASL and SSL encryption: [`openssl`](https://formulae.brew.sh/formula/openssl@1.1) from Homebrew
44+
* OpenSSL 3.0.2 or higher, for STARTTLS, SASL and SSL encryption: [`openssl`](https://formulae.brew.sh/formula/openssl@3.0) from Homebrew
4545
* ODBC library: [`unixodbc`](https://formulae.brew.sh/formula/unixodbc) from Homebrew.
4646

47+
### OpenSSL Version Compatibility
48+
49+
- MongooseIM 6.3.2+ requires OpenSSL 3.0 or newer to compile.
50+
- MongooseIM 6.3.1 and earlier support OpenSSL <3.0 but may have issues with SCRAM authentication when using OpenSSL 3.4.1+. See the [SCRAM hashing issue](../developers-guide/SCRAM-serialization.md#scram-hash-calculation-issue-in-mongooseim-410631) for details.
51+
4752
## Preparing the environment
4853

4954
=== "Rocky/Alma"

0 commit comments

Comments
 (0)