Nextcloud Server Administration Manual Release Latest
Total Page:16
File Type:pdf, Size:1020Kb
Nextcloud Server Administration Manual Release latest The Nextcloud developers Oct 10, 2021 CONTENTS 1 Introduction 1 1.1 Videos and blogs.............................................1 1.2 Target audience..............................................1 2 Release notes 3 3 Maintenance and release schedule5 3.1 Major releases..............................................5 3.2 Maintenance releases...........................................5 3.3 Older versions..............................................6 4 Installation and server configuration7 4.1 System requirements...........................................7 4.2 Deployment recommendations......................................9 4.3 Installation on Linux...........................................9 4.4 Installation wizard............................................ 17 4.5 Installing from command line...................................... 21 4.6 Supported apps.............................................. 22 4.7 SELinux configuration.......................................... 24 4.8 NGINX configuration.......................................... 27 4.9 Hardening and security guidance.................................... 35 4.10 Server tuning............................................... 40 4.11 Example installation on Ubuntu 20.04 LTS............................... 42 4.12 Example installation on CentOS 8.................................... 44 5 Nextcloud configuration 49 5.1 Warnings on admin page......................................... 49 5.2 Using the occ command......................................... 51 5.3 Activity app............................................... 77 5.4 Memory caching............................................. 78 5.5 Background jobs............................................. 82 5.6 Configuration Parameters........................................ 85 5.7 Email................................................... 114 5.8 Linking external sites.......................................... 121 5.9 Language & Locale........................................... 124 5.10 Logging.................................................. 125 5.11 Antivirus scanner............................................. 127 5.12 Reverse proxy.............................................. 132 5.13 Brute force protection.......................................... 135 5.14 Automatic setup............................................. 135 i 5.15 Theming................................................. 137 5.16 OAuth2.................................................. 139 6 Apps management 141 6.1 Apps................................................... 141 6.2 Managing apps.............................................. 142 6.3 Using private API............................................ 143 6.4 Using custom app directories...................................... 143 6.5 Using a self hosted apps store...................................... 143 7 User management 145 7.1 User management............................................ 145 7.2 Resetting a lost admin password..................................... 150 7.3 Resetting a user password........................................ 151 7.4 User password policy........................................... 151 7.5 Two-factor authentication........................................ 152 7.6 User authentication with IMAP, SMB, FTP and others......................... 154 7.7 User authentication with LDAP..................................... 154 7.8 LDAP user cleanup............................................ 170 7.9 The LDAP configuration API...................................... 172 7.10 User provisioning API.......................................... 177 8 File sharing and management 197 8.1 File Sharing............................................... 197 8.2 Configuring Federation Sharing..................................... 201 8.3 Uploading big files > 512MB...................................... 206 8.4 Providing default files.......................................... 209 8.5 Configuring Object Storage as Primary Storage............................. 211 8.6 Configuring External Storage (GUI)................................... 214 8.7 External Storage authentication mechanisms.............................. 226 8.8 Encryption configuration......................................... 227 8.9 Encryption details............................................ 235 8.10 Encryption migration........................................... 244 8.11 Transactional file locking........................................ 244 8.12 Previews configuration.......................................... 245 8.13 Controlling file versions and aging.................................... 247 9 File workflows 249 9.1 Files access control............................................ 249 9.2 Automated tagging of files........................................ 252 9.3 Retention of files............................................. 253 10 Groupware 255 10.1 Calendar................................................. 255 11 Database configuration 257 11.1 Converting database type......................................... 257 11.2 Database configuration.......................................... 258 11.3 Enabling MySQL 4-byte support.................................... 265 11.4 BigInt (64bit) identifiers......................................... 266 12 Mimetypes management 267 12.1 Mimetype aliases............................................. 267 12.2 Mimetype mapping............................................ 267 12.3 Icon retrieval............................................... 268 ii 13 Maintenance 269 13.1 Backup.................................................. 269 13.2 Restoring backup............................................. 270 13.3 How to upgrade............................................. 272 13.4 Upgrade via built-in updater....................................... 274 13.5 Upgrade manually............................................ 288 13.6 Upgrade via packages.......................................... 290 13.7 Migrating to a different server...................................... 292 13.8 Migrating from ownCloud........................................ 293 14 Issues and troubleshooting 295 14.1 General troubleshooting......................................... 295 14.2 Code signing............................................... 301 15 GDPR 307 15.1 Cookies.................................................. 307 iii iv CHAPTER ONE INTRODUCTION Welcome to the Nextcloud Server Administration Guide. This guide describes administration tasks for Nextcloud, the flexible open source file synchronization and sharing solution. Nextcloud includes the Nextcloud server, whichruns on Linux, client applications for Microsoft Windows, macOS and Linux, and mobile clients for the Android and Apple iOS operating systems. Current editions of Nextcloud manuals are always available online at docs.nextcloud.com. Nextcloud server is available: • As a free, full featured community-supported server, with all enterprise features. • Or with full enterprise support, including phone and email access to Nextcloud developers. 1.1 Videos and blogs See the official Nextcloud channel on YouTube for tutorials, overviews, and conference videos. Visit Nextcloud Planet for news and developer blogs. 1.2 Target audience This guide is for users who want to install, administer, and optimize their Nextcloud servers. To learn more about the Nextcloud Web user interface, and desktop and mobile clients, please refer to their respective manuals: • Nextcloud User Manual • Nextcloud Desktop Client 1 Nextcloud Server Administration Manual, Release latest 2 Chapter 1. Introduction CHAPTER TWO RELEASE NOTES See the official changelog for release notes. 3 Nextcloud Server Administration Manual, Release latest 4 Chapter 2. Release notes CHAPTER THREE MAINTENANCE AND RELEASE SCHEDULE This page gives an overview of the currently supported and released versions as well as basic release scheduling. release date end of life 21 2021-02-22 2022-02 20 2020-10-03 2021-10 19 2020-06-03 2021-06 Find the detailed schedule for major and maintenance releases at: GitHub. 3.1 Major releases Major releases are typically scheduled once every 4 months with the first 10 weeks being the development phase followed by freeze phase with four beta release, two RCs and one final each one with an interval of 1 week. Specific dates for each release can be found on GitHub. Major releases are planned to be actively maintained for at least 8 months after their release. For long term support options check out the Nextcloud Subscription offered by Nextcloud GmbH. 3.2 Maintenance releases Maintenance releases are scheduled in a 6 week cycle with one week before the release date having the freeze and RC 1. 5 Nextcloud Server Administration Manual, Release latest 3.3 Older versions release date end of life latest version 18 2020-01-16 2021-01 18.0.14 (2021-01-27) 17 2019-09-30 2020-10 17.0.10 (2020-10-08) 16 2019-04-25 2020-06 16.0.11 (2020-06-04) 15 2018-12-10 2019-12 15.0.14 (2019-12-19) 14 2018-09-10 2019-09 14.0.14 (2019-08-15) 13 2018-02-06 2019-02 13.0.12 (2019-02-28) 12 2017-05-22 2018-11 12.0.13 (2018-11-22) 11 2016-12-13 2018-03 11.0.8 (2018-03-15) 10 2016-08-25 2017-08 10.0.6 (2017-08-07) 9.0 2016-03-08 2017-10 9.0.58 (2017-04-24) 8.2 2015-10-20 2017-05 8.2.11 (2017-04-18) 8.1 2015-07-07 2017-02 8.1.12 (2017-02-02) 8.0 2015-02-09 2016-10 8.0.16 (2016-11-08) 7.0 2014-06-23 2016-05 7.0.15 (2016-05-12) 6.0 2013-12-11 2015-09 6.0.9 (2015-07-07) 5.0 2013-03-14 2015-03 5.0.19 (2015-03-11)