From c001e0b20d1a93f9410c3b385acfdd23f68ce17c Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marius=20Bl=C3=BCm?= Date: Wed, 4 Jul 2018 10:59:44 +0200 Subject: [PATCH 1/4] New system requirements-page MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Marius Blüm --- .../installation/system_requirements.rst | 120 +++++++++++------- 1 file changed, 76 insertions(+), 44 deletions(-) diff --git a/admin_manual/installation/system_requirements.rst b/admin_manual/installation/system_requirements.rst index 01b8fc857..d6454105f 100644 --- a/admin_manual/installation/system_requirements.rst +++ b/admin_manual/installation/system_requirements.rst @@ -2,65 +2,97 @@ System requirements =================== -Memory +Server ------ +For best performance, stability and functionality we have documented some recommendations for running a Nextcloud server. Running Nextcloud with PHP on Windows or macOS is unsupported and will not work as . + +.. note:: If you plan a setup for your organization and you rely on professional deployment consulting (e.g. efficient and + reliable scaling) and support, we strogly recommend you to check out our `enterprise support + `_. + ++------------------+-----------------------------------------------------------------------+ +| Platform | Options | ++==================+=======================================================================+ +| Operating System | - **Ubuntu 16.04/18.04 LTS** (recommended) | +| | - **Red Hat Enterprise Linux 7** (recommended) | +| | - Debian 8 (Jessie), 9 (Strech) | +| | - SUSE Linux Enterprise Server 11 with SP3 & 12 | +| | - openSUSE Leap 42.1+ | +| | - CentOS 7 | ++------------------+-----------------------------------------------------------------------+ +| Memory | - **Apache 2.4 with ``mod_php``, ``php-fpm``** (recommended) | ++------------------+-----------------------------------------------------------------------+ +| Database | - **MySQL or MariaDB 5.5+** (recommended) | +| | - Oracle Database 11g (*only as part of an enterprise subscription*) | +| | - PostgreSQL 9/10 | +| | - SQLite (*only recommended for testing and minimal-instances*) | ++------------------+-----------------------------------------------------------------------+ +| Web server | - **Apache 2.4 with ``mod_php``, ``php-fpm``** (recommended) | +| | - nginx with ``php-fpm`` | ++------------------+-----------------------------------------------------------------------+ +| PHP Runtime | - 7.0 | +| | - 7.1 | +| | - 7.2 | ++------------------+-----------------------------------------------------------------------+ +| *Hypervisors* | - Hyper-V | +| | - VMWare ESX | +| | - Xen | +| | - KVM | ++------------------+-----------------------------------------------------------------------+ + +See :doc:`source_installation` for minimum PHP-modules and additional software for installing Nextcloud. + +Memory +^^^^^^ + Memory requirements for running an Nextcloud server are greatly variable, -depending on the numbers of users and files, and volume of server activity. -Nextcloud needs a minimum of 128MB RAM, and we recommend a minimum of 512MB. +depending on the numbers of users, apps, files and volume of server activity. -Recommended setup for running Nextcloud ---------------------------------------- - -For best performance, stability, and functionality, recommendations are: - -* Red Hat Enterprise Linux 7 / Ubuntu 16.04 LTS -* MySQL/MariaDB -* PHP 7.0, 7.1 or 7.2. -* Apache 2.4 with mod_php - -For a Nextcloud installation with efficient and reliable scaling over ~100 users, see the `deployment recommendations `_. - -Working platforms ------------------ - -* Server: GNU/Linux (Debian 8 (Jessie), 9 (Stretch), SUSE Linux Enterprise Server 11 SP3 & 12, openSUSE LEAP 42.1 or newer, Red Hat Enterprise Linux/CentOS 6.5 and 7 (7 is 64-bit only), Ubuntu 14.04 (Trusty) LTS, 16.04 (Xenial) LTS, 18.04 (Bionic) LTS) -* Web server: Apache 2.4 (mod_php, php-fpm) or Nginx (php-fpm) -* Databases: MySQL or MariaDB 5.5+; PostgreSQL 9, 10; Oracle 11g (currently only possible - as part of an `enterprise subscription `_) -* PHP 5.6, 7.0, 7.1 or 7.2 required -* Hypervisors: Hyper-V, VMware ESX, Xen or KVM -* Desktop: Windows 7+, Mac OS X 10.7+ (64-bit only), Linux (CentOS 6.5, 7 - 64-bit only), - Ubuntu 14.04 LTS, 16.04 LTS, 16.10+, Fedora 21+, openSUSE 13+ and LEAP 41.1+, SLE 11 SP3+ Debian 8+). -* Mobile apps: iOS 9+ (10+ for Talk), Android 4.x+ (5.0+ for Talk) -* Web browser: Recent version of IE11+, Microsoft Edge, Mozilla Firefox, Google Chrome/Chromium, Safari or browers based on those. Nextcloud Talk requires Mozilla Firefox 52 or later or Chrome 49 or later. - - -See :doc:`source_installation` for minimum software versions for installing -Nextcloud. If you encounter problems, visit the `home user forums `_ -or `enterprise support portal `_. +Nextcloud needs a minimum of **128MB** RAM, and we recommend a minimum of **512MB**. Database requirements for MySQL / MariaDB ------------------------------------------ +^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ The following is currently required if you're running Nextcloud together with a MySQL / MariaDB database: * InnoDB storage engine (MyISAM is not supported) * "READ COMMITED" transaction isolation level (See: :ref:`db-transaction-label`) * Disabled or BINLOG_FORMAT = ROW configured Binary Logging (See: https://dev.mysql.com/doc/refman/5.7/en/binary-log-formats.html) +* For **Emoji (UTF8 4-byte) support** see :doc:`../configuration_database/mysql_4byte_support` -Emoji (UTF8 4-byte) support with MySQL / MariaDB -^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^ +Desktop client +-------------- -If you want to use UTF8 4-byte characters such as Emojis on your server, the database needs to be created with character set ``utf8mb4`` and collate ``utf8mb4_general_ci``, e.g.:: +We strongly recommend using the latest version of your operating system to get the full and most stable experience out +of our clients. - CREATE DATABASE nextcloud CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci; +* **Windows** 7+ +* **macOS** Lion (10.7)+ (64-bit only) +* **Linux** (CentOS 6.5+, Ubuntu 14.04+, Fedora 21+, openSUSE 13, SUSE Linux Enterprise 11 SP3+, Debian 8 (Jessie)+, Red Hat + Enterprise Linux 7) -Additionally the following InnoDB settings need to be set:: +Mobile apps +----------- - [mysqld] - innodb_large_prefix=on - innodb_file_format=barracuda - innodb_file_per_table=true +We strongly recommend using the latest version of your mobile operating system to get the full and most stable experience out +of our mobile apps. -See :doc:`../configuration_database/mysql_4byte_support` for more information. +- **iOS** 9.x+ +- **Android** 4.x+ + +.. note:: Nextcloud Talk requires iOS 9.x+ or Android 5.x+. + +Webbrowser +---------- + +For best experience with the Nextcloud webinterface, we recommend you to use the latest and supported version of a browser from this list, or one based on those: + +- Microsoft **Internet Explorer 11** (latest version) +- Microsoft **Edge** +- Mozilla **Firefox** +- Google **Chrome**/Chromium +- Apple **Safari** + +.. note:: If you want to use Nextcloud Talk you should use Mozilla Firefox 52+ or Google Chrome/Chromium 49+ to have the full + experience with video calls and screensharing. Google Chrome/Chromium requires a additional plugin for screensharing From 9fbf7ae7f64475506f1c1c17931293e8c0d6dbe5 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marius=20Bl=C3=BCm?= Date: Wed, 4 Jul 2018 11:31:00 +0200 Subject: [PATCH 2/4] Remove Hypervisors MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Marius Blüm --- admin_manual/installation/system_requirements.rst | 5 ----- 1 file changed, 5 deletions(-) diff --git a/admin_manual/installation/system_requirements.rst b/admin_manual/installation/system_requirements.rst index d6454105f..292dca962 100644 --- a/admin_manual/installation/system_requirements.rst +++ b/admin_manual/installation/system_requirements.rst @@ -35,11 +35,6 @@ For best performance, stability and functionality we have documented some recomm | | - 7.1 | | | - 7.2 | +------------------+-----------------------------------------------------------------------+ -| *Hypervisors* | - Hyper-V | -| | - VMWare ESX | -| | - Xen | -| | - KVM | -+------------------+-----------------------------------------------------------------------+ See :doc:`source_installation` for minimum PHP-modules and additional software for installing Nextcloud. From bbba50603ad24177590c86a738e39333c7f79295 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marius=20Bl=C3=BCm?= Date: Wed, 4 Jul 2018 11:50:20 +0200 Subject: [PATCH 3/4] Implement feedback from @juliushaertl MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Marius Blüm --- admin_manual/installation/system_requirements.rst | 2 -- 1 file changed, 2 deletions(-) diff --git a/admin_manual/installation/system_requirements.rst b/admin_manual/installation/system_requirements.rst index 292dca962..bf5ea49a8 100644 --- a/admin_manual/installation/system_requirements.rst +++ b/admin_manual/installation/system_requirements.rst @@ -21,8 +21,6 @@ For best performance, stability and functionality we have documented some recomm | | - openSUSE Leap 42.1+ | | | - CentOS 7 | +------------------+-----------------------------------------------------------------------+ -| Memory | - **Apache 2.4 with ``mod_php``, ``php-fpm``** (recommended) | -+------------------+-----------------------------------------------------------------------+ | Database | - **MySQL or MariaDB 5.5+** (recommended) | | | - Oracle Database 11g (*only as part of an enterprise subscription*) | | | - PostgreSQL 9/10 | From 1a17ec33543c295aeb982aa9ebc51a689cf9f683 Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?Marius=20Bl=C3=BCm?= Date: Wed, 4 Jul 2018 13:26:08 +0200 Subject: [PATCH 4/4] Layout fixes MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Signed-off-by: Marius Blüm --- admin_manual/installation/system_requirements.rst | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/admin_manual/installation/system_requirements.rst b/admin_manual/installation/system_requirements.rst index bf5ea49a8..4d1f10a67 100644 --- a/admin_manual/installation/system_requirements.rst +++ b/admin_manual/installation/system_requirements.rst @@ -62,7 +62,7 @@ of our clients. * **Windows** 7+ * **macOS** Lion (10.7)+ (64-bit only) -* **Linux** (CentOS 6.5+, Ubuntu 14.04+, Fedora 21+, openSUSE 13, SUSE Linux Enterprise 11 SP3+, Debian 8 (Jessie)+, Red Hat +* **Linux** (CentOS 6.5+, Ubuntu 14.04+, Fedora 21+, openSUSE 13, SUSE Linux Enterprise 11 SP3+, Debian 8 (Jessie)+, Red Hat Enterprise Linux 7) Mobile apps @@ -74,7 +74,7 @@ of our mobile apps. - **iOS** 9.x+ - **Android** 4.x+ -.. note:: Nextcloud Talk requires iOS 9.x+ or Android 5.x+. +.. note:: The separate Nextcloud Talk app requires iOS 9.x+ or Android 5.x+. Webbrowser ---------- @@ -87,5 +87,6 @@ For best experience with the Nextcloud webinterface, we recommend you to use the - Google **Chrome**/Chromium - Apple **Safari** -.. note:: If you want to use Nextcloud Talk you should use Mozilla Firefox 52+ or Google Chrome/Chromium 49+ to have the full - experience with video calls and screensharing. Google Chrome/Chromium requires a additional plugin for screensharing +.. note:: If you want to use Nextcloud Talk you should use Mozilla **Firefox** 52+ or Google **Chrome**/Chromium 49+ to have + the full experience with video calls and screensharing. Google Chrome/Chromium requires a additional plugin for + screensharing.