Server Administration Manual Release Latest
Total Page:16
File Type:pdf, Size:1020Kb
Nextcloud Server Administration Manual Release latest The Nextcloud developers Oct 01, 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.................................... 36 4.10 Server tuning............................................... 40 4.11 Example installation on Ubuntu 20.04 LTS............................... 42 4.12 Example installation on CentOS 8.................................... 44 4.13 Example installation on OpenBSD.................................... 48 5 Nextcloud configuration 53 5.1 Warnings on admin page......................................... 53 5.2 Using the occ command......................................... 55 5.3 Activity app............................................... 81 5.4 Memory caching............................................. 82 5.5 Background jobs............................................. 87 5.6 Configuration Parameters........................................ 89 5.7 Email................................................... 120 5.8 Linking external sites.......................................... 127 5.9 Language & Locale........................................... 130 5.10 Logging.................................................. 131 5.11 Antivirus scanner............................................. 134 5.12 Reverse proxy.............................................. 138 5.13 Brute force protection.......................................... 141 i 5.14 Automatic setup............................................. 142 5.15 Theming................................................. 144 5.16 OAuth2.................................................. 146 5.17 Admin right priviledge.......................................... 147 6 Apps management 149 6.1 Apps................................................... 149 6.2 Managing apps.............................................. 150 6.3 Using private API............................................ 151 6.4 Using custom app directories...................................... 151 6.5 Using a self hosted apps store...................................... 151 7 User management 153 7.1 User management............................................ 153 7.2 Resetting a lost admin password..................................... 158 7.3 Resetting a user password........................................ 159 7.4 User password policy........................................... 159 7.5 Two-factor authentication........................................ 160 7.6 User authentication with IMAP, SMB, FTP and others......................... 162 7.7 User authentication with LDAP..................................... 162 7.8 LDAP user cleanup............................................ 178 7.9 The LDAP configuration API...................................... 180 7.10 User provisioning API.......................................... 185 8 File sharing and management 205 8.1 File Sharing............................................... 205 8.2 Configuring Federation Sharing..................................... 209 8.3 Uploading big files > 512MB...................................... 214 8.4 Providing default files.......................................... 217 8.5 Configuring Object Storage as Primary Storage............................. 219 8.6 Configuring External Storage (GUI)................................... 222 8.7 External Storage authentication mechanisms.............................. 234 8.8 Encryption configuration......................................... 235 8.9 Encryption details............................................ 243 8.10 Encryption migration........................................... 252 8.11 Transactional file locking........................................ 252 8.12 Previews configuration.......................................... 253 8.13 Controlling file versions and aging.................................... 255 9 File workflows 257 9.1 Files access control............................................ 257 9.2 Automated tagging of files........................................ 260 9.3 Retention of files............................................. 261 10 Groupware 263 10.1 Calendar / CalDAV............................................ 263 11 Database configuration 265 11.1 Converting database type......................................... 265 11.2 Database configuration.......................................... 266 11.3 Enabling MySQL 4-byte support.................................... 273 11.4 BigInt (64bit) identifiers......................................... 274 12 Mimetypes management 275 12.1 Mimetype aliases............................................. 275 ii 12.2 Mimetype mapping............................................ 275 12.3 Icon retrieval............................................... 276 13 Maintenance 277 13.1 Backup.................................................. 277 13.2 Restoring backup............................................. 278 13.3 How to upgrade............................................. 280 13.4 Upgrade via built-in updater....................................... 282 13.5 Upgrade manually............................................ 296 13.6 Upgrade via packages.......................................... 298 13.7 Migrating to a different server...................................... 300 13.8 Migrating from ownCloud........................................ 301 14 Issues and troubleshooting 303 14.1 General troubleshooting......................................... 303 14.2 Patching Nextcloud............................................ 309 14.3 Code signing............................................... 310 15 GDPR-compliance 315 15.1 Cookies.................................................. 315 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 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 our blog for latest news and to learn more about what is going on in and around Nextcloud. 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 22 2021-07-06 2022-07 21 2021-02-22 2022-02 20 2020-10-03 2021-10 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 19 2020-06-03 2021-06 19.0.13 (2021-07-01) 18 2020-01-16 2021-01 18.0.14 (2021-01-27) 17 2019-09-30 2020-10 17.0.10 (2020-10-08) 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