Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Temporary fix for the openSSL v3 incompatibility #373

Merged
merged 2 commits into from
May 24, 2022
Merged

Temporary fix for the openSSL v3 incompatibility #373

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
dc95d9a
fix openssl
mmattel May 24, 2022
f5cf812
Apply suggestions from code review
mmattel May 24, 2022
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
24 changes: 22 additions & 2 deletions ...l/pages/installation/manual_installation/manual_installation_prerequisites.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -7,6 +7,7 @@
:pecl-package-url: https://pecl.php.net/package
:sabre-url: http://sabre.io/
:gnu-make-url: https://www.gnu.org/software/make/
:wiki-openssl-3-url: https://wiki.openssl.org/index.php/OpenSSL_3.0

== Introduction

Expand All @@ -23,14 +24,33 @@ If you get a result, the module is present.

== Required Prerequisites

=== openSSL Version

ownCloud requires that you have openSSL version 1.1.x installed. With the release change of openSSL v1.x to openSSL version 3.x in December 2021, some ciphers which were valid in version 1.x, have been retired with immediate effect. This impacts the ownCloud encryption app.

[IMPORTANT]
====
If you plan to:

* upgrade the openSSL version of your server to v3 **or**
* install or upgrade your server where the server upgrade delivers the new openSSL v3 version **and**
* you have enabled and use encryption

your encryption environment will break due to openSSL v3 retired (legacy) ciphers. As a result, encrypted files cant be accessed. As a _temporary solution_, you have to manually reenable in the openSSL v3 config the legacy ciphers. To do so, see the example in the {wiki-openssl-3-url}[OpenSSL 3.0 Wiki] at section **6.2 Providers**.
====

=== PHP Version

ownCloud can run with following PHP versions: {supported-php-versions}

[IMPORTANT]
====
ownCloud recommends PHP 7.4 for new installations.
Sites using a version earlier than PHP 7.3 are *strongly encouraged* to migrate at least to PHP 7.3.
ownCloud recommends PHP 7.4 for new installations. Sites using a version earlier than PHP 7.3 are *strongly encouraged* to migrate at least to PHP 7.3.
====

[IMPORTANT]
====
Note that PHP 8.x is currently not supported.
====

==== PHP Extensions
Expand Down
55 changes: 32 additions & 23 deletions modules/admin_manual/pages/installation/system_requirements.adoc
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -6,26 +6,36 @@
:ios-system-requirements-url: https://doc.owncloud.com/ios-app/ios_faq.html
:android-system-requirements-url: https://doc.owncloud.com/android/faq.html

:description: Read this documentation for a recommended or supported environment for your ownCloud Server. This documentation applies to both a new installation or upgrade of an existing installation.

== Introduction

{description}

== General Note

There is an important note about a xref:installation/manual_installation/manual_installation_prerequisites.adoc#openssl-version[prerequisite of openSSL]. We highly recommend checking this prerequisite as it needs to be checked regardless of the Operating System chosen.

== Officially Recommended Environment

For _best performance_, _stability_, _support_ and _full functionality_, we officially recommend and support:

[cols="1,2a",options="header"]
[width="60%"cols="30%,60%a",options="header"]
|===
|Platform
|Options
| Platform
| Options

|Operating System
|Ubuntu 20.04 LTS
| Operating System
| Ubuntu 20.04 LTS

|Database
|MariaDB 10.5 ^1^
| Database
| xref:#database-requirements[MariaDB] 10.5 ^1^

|Web server
|Apache 2.4 with xref:installation/manual_installation/manual_installation.adoc#configure-the-web-server[`prefork and mod_php`]
| Web server
| Apache 2.4 with xref:installation/manual_installation/manual_installation.adoc#configure-the-web-server[`prefork and mod_php`]

|PHP Runtime
|{recommended-php-version}
| PHP Runtime
| {recommended-php-version}
|===

(1) MariaDB 10.6 is *only supported* with ownCloud release 10.9 and upwards. See the xref:installation/manual_installation/manual_installation.adoc#install-a-database[Install a Database] guide and xref:maintenance/upgrading/database_upgrade.adoc[Database Upgrade] guide.
Expand All @@ -36,30 +46,29 @@ For _best performance_, _stability_, _support_, and _full functionality_ we offi

=== Server

[cols="1,2a",options="header"]
[width="90%"cols=".^ 30%,90%a",options="header"]
|===
|Platform
|Options
| Platform
| Options

|Operating System (64bit)
|
* Debian 10
* Red Hat Enterprise Linux 7 and 8 including all 100% compatible derivatives
| Operating System (64bit)
| * Debian 10
* Red Hat Enterprise Linux 7 and 8 +
including all 100% compatible derivatives
* SUSE Linux Enterprise Server 12 with SP4/5 and 15
* Ubuntu 20.04
* openSUSE Leap 15.2

|Database
|
* MySQL 8+ or MariaDB 10.2, 10.3, 10.4 or 10.5 ^1^ (*Recommended*)
* Oracle 11 and 12
| Database
| * xref:#database-requirements[MySQL] 8+ or xref:#database-requirements[MariaDB] 10.2, 10.3, 10.4 or 10.5 ^1^ (*Recommended*)
* Oracle 11 and 12 (*Enterprise only*)
* PostgreSQL 9, 10, 11, 12, 13 or 14
* SQLite (*Not for production*)

|Web server
|* Apache 2.4 with xref:installation/manual_installation/manual_installation.adoc#configure-the-web-server[`prefork` and `mod_php`]

|PHP Runtime
| PHP Runtime
|* {supported-php-versions}
|===

Expand Down