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
occcommand 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_customprefixconfiguration β Documented caching configuration withmemcache_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
occcommand 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
dbhostanddefault_languageparameters β 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_NICEcapability (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 upgradebehavior β 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
--urloption β 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.RewriteBaseclarification β Clarified that it refers to the backend path rather than the public reverse-proxy URL. by @skjnldsv in #14945NEXTCLOUD_CONFIG_DIRenvironment 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
updateAttributesIntervalremoval β 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:keyscommand β 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
createFunctionusage. 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
occcommand coverage β Expanded developer manual coverage forocccommands. 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
skipAuthPickerApplicationsOAuth2 setting β Documented the setting for OAuth2 flows. by @come-nc in #14728IAppManagerdeprecations (Nextcloud 32) β Documented deprecations and new methods. by @come-nc in #14731IMigratorimplementation 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_Responseremoval (Nextcloud 33) β Documented the removal and the supported replacement path. by @come-nc in #14752- Support admin delegation settings β Added
info.xmldocumentation 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_activityandcreationdateβ 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.rstfor 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_emailtoggle β 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.