Nextcloud Documentation v34.0.0

What's Changed

Full Changelog: v33.0.0...v34.0.0

🖥️ Admin Manual

• Mail documentation structure — Reorganized with a dedicated troubleshooting section, making mail administration easier to navigate and maintain. by @DerDreschner in #14001
• Oracle support and database guidance — Clarified Oracle support and updated the recommended database guidance for production deployments. by @jospoortvliet in #14005
• PostgreSQL version requirements — Corrected the supported PostgreSQL version list in the system requirements documentation. by @szaimen in #14025
• Live Transcription and AI integration — Added live translation documentation for Live Transcription, including how the feature fits into AI-assisted setups. by @kyteinsky in #14045
• AI Context Chat scaling — Updated scaling guidance for parsing workloads. by @kyteinsky in #14047
• Energy consumption — Added energy consumption information to the admin docs. by @AndyScherzinger in #14057
• S3 integrity protection — Clarified that S3 integrity protection is now opt-in in the release notes and related admin guidance. by @kesselb in #14039
• Server-side encryption documentation — Restructured and modernized for clarity, correctness, and better troubleshooting coverage. by @joshtrichards in #13754
• Supported Linux distributions — Added supported Linux distribution guidance for current server releases. by @susnux in #14099
• Recognize app documentation — Updated to remove outdated references to the Photos app. by @marcelklehr in #14081
• Contacts Interaction app — Documented the app and its administrative context. by @ChristophWurst in #14129
• nginx PHP location block — Improved the example for clearer and safer configuration. by @joshtrichards in #14172
• AI Act compliance documentation — Expanded the admin docs with AI Act documentation and configuration guidance. by @marcelklehr in #14169
• occ command reference structure — Split into topic-based subpages to make command documentation easier to navigate. by @miaulalala in #14340
• Activity app setup and behavior — Expanded with fuller setup and behavior coverage. by @miaulalala in #14306
• memcache_customprefix configuration — Documented caching configuration with memcache_customprefix. by @Earl0fPudding in #14080
• Backup and restore guidance — Clarified with more complete backup documentation. by @rickysixx in #11470
• Data directory permissions troubleshooting — Refined the write-up for data directory handling and permissions. by @joshtrichards in #14107
• SELinux and NFS data directories — Added SELinux guidance for NFS-backed data directories. by @brlin-tw in #14019
• GDPR compliance guide — Expanded from a single cookies page into a fuller compliance guide. by @miaulalala in #14607
• occ command reference completion — Completed and expanded coverage across files, encryption, DAV, database, user, and group commands. by @miaulalala in #14601, #14604, #14558, #14559, and #14560
• Admin manual accuracy and prose — Fixed critical accuracy and prose issues across multiple pages. by @miaulalala in #14610, #14620, and #14643
• Ubuntu 26.04 support and PHP 8.5 — Added Ubuntu 26.04 support and updated the PHP recommendation to PHP 8.5. by @nickvergessen in #14652
• Logging configuration guidance — Improved for completeness and accuracy. by @joshtrichards in #14221
• Encryption recovery key behavior — Clarified recovery key behavior for master-key versus per-user-key encryption modes. by @skjnldsv in #14791
• WOPI configuration settings — Documented WOPI settings more accurately in the configuration manual. by @skjnldsv in #14787
• Optional services in the migration guide — Added guidance about optional services. by @skjnldsv in #14792
• Apache modules for PHP-FPM — Documented required Apache modules for PHP-FPM setups. by @skjnldsv in #14794
• dbhost and default_language parameters — Improved descriptions of these configuration parameters. by @skjnldsv in #14790 and #14789
• PHP module bundling (PHP 8.3 and 8.4) — Clarified bundling expectations for PHP 8.3 and 8.4. by @skjnldsv in #14793
• ClamAV and encrypted files — Extended antivirus documentation with ClamAV limitations when files are encrypted. by @Antreesy in #14802
• Preview provider dependencies — Documented so admins can better provision image and document preview support. by @mzl2233 in #14858
• App management API documentation — Moved into a more appropriate Apps section for better discoverability. by @skjnldsv in #14851
• MariaDB backup and restore — Added dedicated sections using MariaDB-native tooling. by @skjnldsv in #14850
• PHP OPcache documentation link — Replaced a dead link with the correct current reference. by @Crizomb in #14871
• SYS_NICE capability (Imaginary) — Clarified that the note applies only to Docker deployments. by @skjnldsv in #14905
• Web server ownership and permissions — Clarified that example values are distro-specific and that correct read/write access matters more than literal ownership. by @skjnldsv in #14911
• Brute-force protection and fail2ban — Added guidance comparing built-in protection with fail2ban and explaining why both can be useful together. by @skjnldsv in #14909
• Groupware version references — Standardized so admins can more easily tell whether a version refers to Nextcloud or an app release. by @DerDreschner in #14921
• occ upgrade behavior — Clarified that it runs migrations but does not replace application code. by @skjnldsv in #14848
• MySQL collation recommendation — Updated the recommended collation to utf8mb4_bin. by @come-nc in #14959
• __Host- cookie prefix warning — Documented the warning and how to resolve it in secure deployments. by @skjnldsv in #14956
• Updater --url option — Documented for offline and air-gapped installations. by @skjnldsv in #14846
• Stable anchor IDs for caching sections — Restored stable anchor IDs for the APCu, Redis, and Memcached sections so existing links continue to work. by @skjnldsv in #14948
• htaccess.RewriteBase clarification — Clarified that it refers to the backend path rather than the public reverse-proxy URL. by @skjnldsv in #14945
• NEXTCLOUD_CONFIG_DIR environment variable — Documented the variable and its deployment implications. by @skjnldsv in #14944
• PHP-FPM tuning guidance — Expanded with more practical recommendations. by @skjnldsv in #14994
• nginx Unix socket and HTTP/3 tips — Added tips for Unix socket proxying and HTTP/3 host detection. by @skjnldsv in #14991
• External storage change detection — Documented how it works, including known limitations. by @skjnldsv in #14937
• LDAP updateAttributesInterval removal — Replaced the removed setting documentation with current synchronization behavior. by @skjnldsv in #15020
• LDAP "Configuration Active" testing — Added a warning about enabling the setting too early during LDAP testing. by @skjnldsv in #14904
• Share link URLs and trusted domains — Documented how share link URLs behave when multiple trusted domains are configured. by @skjnldsv in #14989
• CLI updater precedence — Updated documentation to present the CLI updater before the web updater. by @skjnldsv in #14939
• ocm:keys command — Added documentation to the admin manual. by @mickenordin in #15052
• AI assistant administration — Added documentation and supporting context. by @miaulalala in #15058
• ExApp container log rotation — Documented container log rotation behavior. by @oleksandr-nc in #15053
• AI Context Chat: embedding model and multi-tenancy — Added notes about embedding model immutability after installation and multi-tenancy considerations. by @marcelklehr in #15024 and #15025
• Hardening documentation cleanup — Removed an outdated note. by @skjnldsv in #15045

🧑‍💻 Developer Manual

• Database examples — Ported away from deprecated createFunction usage. by @CarlSchwan in #14012
• "What's New" feature removal — Documented the removal for developers. by @susnux in #14033
• TaskProcessing API (Nextcloud 33 upgrade guide) — Added TaskProcessing API updates to the Nextcloud 33 upgrade guide. by @marcelklehr in #14046
• Nextcloud 34 developer changes — Added the first wave of Nextcloud 34 developer change documentation. by @susnux in #14079
• ITypedQueryBuilder (Nextcloud 34) — Added a note about its introduction in Nextcloud 34. by @provokateurin in #14085
• OCS documentation — Reorganized and modernized with clearer code snippets and explanations. by @joshtrichards in #14071
• AppConfig documentation — Reorganized, expanded, and clarified. by @joshtrichards in #14111
• Context Agent and AI tools — Documented more Context Agent tools and AI-related capabilities for developers. by @marcelklehr in #14164
• Release notes preparation guide — Added instructions for maintainers on how to prepare release notes. by @joshtrichards in #14186
• Logging chapter overhaul — Overhauled for better accuracy and completeness. by @joshtrichards in #14187
• IVersionBackend::getRevision — Added documentation. by @bdovaz in #13386
• Backport considerations — Added backport considerations to the development process documentation. by @joshtrichards in #12484
• WebDAV basic operations reference — Expanded and corrected. by @joshtrichards in #14136
• New and deprecated API pages — Moved into dedicated pages to make release changes easier to track. by @ChristophWurst in #14183
• Critical app changes (Nextcloud 34) — Drafted critical app changes for Nextcloud 34. by @ChristophWurst in #14565
• Developer release notes cleanup — Cleaned up and consolidated release notes in the developer docs. by @ChristophWurst in #14574 and @susnux in #14661
• Global Handlebars removal (Nextcloud 34) — Documented the removal of global Handlebars. by @susnux in #14587
• Developer manual occ command coverage — Expanded developer manual coverage for occ commands. by @miaulalala in #14605
• Node.js and npm prerequisites — Added Node.js and npm prerequisites to the front-end code guide. by @Copilot in #14640
• CSS RTL/LTR guidelines — Added CSS RTL/LTR guidelines for developers. by @hamza221 in #13999
• Controller session variables and locking — Clarified usage, locking, and best practices. by @joshtrichards in #14037
• OCS capabilities documentation — Improved. by @zak39 in #12084
• Dependency injection chapter — Corrected code examples. by @joshtrichards in #13840
• IConversationOptions — Added documentation. by @nickvergessen in #14261 and #14263
• Developer manual corrections — Corrected code and prose errors across Flow, ExApp, XML, and broader example fixes. by @miaulalala in #14312, #14313, #14615, #14619, and #14644
• Activity API documentation — Consolidated developer documentation for the Activity API. by @miaulalala in #14307
• Utility API deprecations — Added deprecation notices for utility APIs. by @CarlSchwan in #14797
• Context Chat and Context Agent documentation — Added documentation including Kubernetes compatibility and new mail tools. by @marcelklehr in #14677 and #14772, and by @janepie in #14788
• skipAuthPickerApplications OAuth2 setting — Documented the setting for OAuth2 flows. by @come-nc in #14728
• IAppManager deprecations (Nextcloud 32) — Documented deprecations and new methods. by @come-nc in #14731
• IMigrator implementation guidance — Improved with clearer guidance and better examples. by @come-nc in #14727
• Upcoming method and class removals — Documented upcoming removals. by @come-nc in #14735
• Legacy autoloader removal (Nextcloud 32) — Documented the removal. by @come-nc in #14741
• OC_Response removal (Nextcloud 33) — Documented the removal and the supported replacement path. by @come-nc in #14752
• Support admin delegation settings — Added info.xml documentation for the feature added in Nextcloud 33. by @come-nc in #14798
• UX writing guide — Added a UX writing guide for user-facing strings to the design docs. by @skjnldsv in #14997
• Developer glossary — Added a developer glossary to the getting-started section. by @miaulalala in #15023
• Login flow v2 diagram — Added a login flow v2 diagram and a follow-up grant-step clarification. by @artonge in #14972 and #15011
• Critical changes list formatting — Fixed the formatting of the critical changes list. by @come-nc in #15001
• Direct editing documentation — Added. by @juliusknorr in #15063
• Latest deprecations and removals — Added the latest batch of deprecations and removals. by @CarlSchwan in #15066
• Branch-off release notes (post-v35) — Added release notes for the new development cycle after version 35 became current. by @susnux in #15067
• Design guidelines and screenshots — Updated design guidelines and added new screenshots. by @nimishavijay in #15002
• Autocomplete share type values — Clarified autocomplete share type values. by @mzl2233 in #14855
• Groupware version references — Standardized so developers can more easily distinguish app versions from Nextcloud release versions. by @DerDreschner in #14921

👤 User Manual

• Automated appointment creation — Added documentation. by @SebastianKrupinski in #14009
• Mail compact mode — Documented compact mode in the Mail app. by @GretaD in #13973
• Talk 23 / Nextcloud 33 features — Added feature documentation. by @Antreesy in #14065
• Client integration and tutorial section — Added client integration documentation and a tutorial section, including follow-up image-size improvements. by @tobiasKaminsky in #14052 and @mpivchev in #14089 and #14083
• Unified search in Mail — Documented unified search support in the Mail app. by @ChristophWurst in #14159
• CalDAV and CardDAV setup (macOS) — Updated guidance for recent macOS versions. by @jameskimmel in #14143
• Citrix installation note — Added a Citrix-related installation note to the desktop docs. by @camilasan in #14119
• Android Files client minimum version — Increased the minimum Android Files client version in the documentation. by @alperozturk96 in #14165
• DAV properties: last_activity and creationdate — Added to the supported DAV properties tables. by @cristianscheid in #14168 and #14110
• Talk documentation structure — Split and reorganized into smaller, clearer sections. by @nickvergessen in #13051
• User manual prose and link fixes — Corrected typos, grammar, and several broken or stale links across user manual pages. by @miaulalala in #14308, #14309, and related cleanup PRs
• Activity app user manual — Added a dedicated user manual page for the Activity app. by @miaulalala in #14305
• Desktop client: x64-only and safe removal — Updated documentation for x64-only builds and safe removal instructions. by @nilsding in #14325 and @camilasan in #14328
• Talk bots and commands — Rewrote the page and resolved FIXME items across Talk docs. by @miaulalala in #14356 and #14358
• File access navigation — Grouped file-access topics under "Accessing your files" for clearer navigation. by @miaulalala in #14334
• Talk call documentation — Enhanced. by @miaulalala in #13114
• Office and productivity AI features — Added documentation. by @juliusknorr in #14126
• Desktop client AI chat support — Added guidance for AI chat support. by @Rello in #14084
• Collectives documentation — Added documentation and later clarified related user-facing details. by @mejo- in #14730, #14780, and #14874
• Calendar default reminder — Added documentation for the default reminder feature. by @GVodyanov in #14120
• Web interface documentation — Rewrote webinterface.rst for Nextcloud 33 with refreshed screenshots. by @miaulalala in #14758
• AppAPI optional status — Clarified optional status in AppAPI-related docs. by @IBBoard in #14000
• ldap:check-user --all-seen-users — Added documentation where user workflows are affected. by @come-nc in #14754
• User manual screenshots — Refreshed screenshots and descriptions across the user manual. by @miaulalala in #14742
• External storage file name encoding — Moved guidance to the right chapter. by @joshtrichards in #13787
• Email address changed notification setting — Moved to the User Management chapter. by @joshtrichards in #13790
• Apache service discovery (subfolder installs) — Improved troubleshooting guidance for subfolder installs. by @Copilot in #14778
• Activity app enable_email toggle — Clarified the scope of the toggle and queue-drain behavior. by @miaulalala in #14781
• Windmill documentation — Added Windmill documentation updates. by @janepie in #14762
• Optional services migration guidance — Added migration guidance around optional services. by @skjnldsv in #14792
• Mail folder terminology — Improved to consistently use "folder" where appropriate. by @MukundaKatta in #14860
• WebDAV performance known issue — Added a Known Problems entry for slow WebDAV performance. by @skjnldsv in #14908
• System tags — Added a user manual page for system tags. by @skjnldsv in #14970
• EPUB output — Added EPUB output for the user manual. by @skjnldsv in #14975
• Collectives folder setting — Clarified that the folder setting is per user. by @mejo- in #14872
• WebDAV access documentation — Cleaned up prose and reStructuredText style in access_webdav.rst. by @Copilot in #14869
• AI assistant user documentation — Added. by @miaulalala in #15054
• Calendar delegation — Added Calendar delegation documentation. by @GVodyanov in #15007
• Contacts favorites — Added documentation for marking contacts as favorites. by @GretaD in #15010
• Mail account delegation — Added Mail account delegation documentation. by @hamza221 in #15064
• Desktop files client link — Fixed a broken link to the desktop files client user manual. by @mgallien in #15080
• Groupware version references — Standardized so users can better tell whether a version refers to Nextcloud or a Groupware app. by @DerDreschner in #14921

🎉 Contributors

This release had more than 25 individual contributors! Here are some random shout-outs:

• Thanks @miaulalala for contributing many PRs to this release 🎊
• Thanks @skjnldsv for contributing many PRs to this release 🎊
• Thanks @come-nc for contributing multiple PRs to this release 🎊
• Thanks @Earl0fPudding for contributing #14080 🎊
• Thanks @rickysixx for contributing #11470 🎊
• Thanks @Crizomb for contributing #14871 🎊
• Thanks @oleksandr-nc for contributing #15053 🎊
• Thanks @mickenordin for contributing #15052 🎊
• Thanks @mzl2233 for contributing #14855 🎊
• Thanks @bdovaz for contributing #13386 🎊
• Thanks @mpivchev for contributing #14083 🎊
• Thanks @cristianscheid for contributing #14076 🎊
• Thanks @IBBoard for contributing #14000 🎊

Additional contributors: @hweihwang, @o-kotb, @i2h3, @MartinZeitNextcloud, @taiebot, @hqsolomo, @kinafu, @synq, @JeffMatson, @mvanhorn, @rich-gg, @Koruudo, @sunetfreitag, @bhugh, @manik0u, and @Helianthropy 🎊

Note: Backports in this release were created by @backportbot, but original authors and their contributions are credited above. AI assisted; verify official details in the change commits.