Releases: nextcloud/documentation
v34.0.0
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 — ...
v33.0.5
Nextcloud Documentation v33.0.5
What's Changed
Full Changelog: v33.0.4...v33.0.5
🖥️ Admin Manual
stable33deploy workflow — Refined so documentation deploys no longer open unnecessary pull requests when the only changes are autogeneratedlastupdatedtimestamps in HTML or regenerated EPUB/PDF artifacts, reducing release-maintenance noise for administrators and docs maintainers. by @Copilot in #15049
🎉 Contributors
Note: Some PRs in this release are backports to the
stable33branch via @backportbot. Original authors and their contributions are credited above. AI assisted; verify official details in the change commits.
v33.0.4
Nextcloud Documentation v33.0.4
What's Changed
Full Changelog: v33.0.3...v33.0.4
🖥️ Admin Manual
skipAuthPickerApplicationsOAuth2 setting — Documented the new setting so administrators can control when the auth picker is skipped in supported OAuth2 flows. by @come-nc in #14734- Brute-force protection and fail2ban — Clarified that the built-in brute-force protection and fail2ban operate at different layers and are best used together. by @skjnldsv in #14926
- MariaDB backup and restore — Added dedicated MariaDB backup and restore instructions instead of relying on MySQL command substitutions. by @skjnldsv in #14879
- PHP OPcache documentation — Replaced an outdated link with the current PHP OPcache documentation target. by @Crizomb in #14884
- Groupware and Mail user migration — Added notes about user migration capabilities for Groupware and Mail-related setups so admins know what migration support exists. by @DerDreschner in #14887
- Web server ownership and permissions — Clarified that web server ownership examples use distro-specific usernames and that the real requirement is correct read/write access. by @skjnldsv in #14917
SYS_NICEcapability (Imaginary) — Clarified that theSYS_NICEcapability note applies only to Docker-based Imaginary deployments. by @skjnldsv in #14915htaccess.RewriteBaseclarification — Clarified thathtaccess.RewriteBaserefers to the backend Apache path, not the public URL prefix seen behind a reverse proxy. by @skjnldsv in #14946NEXTCLOUD_CONFIG_DIRenvironment variable — Documented the variable, including when to use it and how to keep config outside the web root. by @skjnldsv in #14951- Recommended MySQL collation — Updated the recommended MySQL collation to
utf8mb4_bin. by @come-nc in #14960 - Stable anchor IDs for caching sections — Restored stable anchor IDs for the APCu, Redis, and Memcached sections so existing links continue to work. by @backportbot in #14949
__Host-cookie prefix warning — Documented the warning and how to resolve it in secure deployments. by @skjnldsv in #14957occ group:adduserandgroup:removeusercommands — Extended the documentation for both group membership commands. by @blizzz in #14966- LDAP synchronization:
updateAttributesIntervalremoval — Replaced the removed setting docs with the current LDAP synchronization behavior. by @backportbot in #15022 - Groupware app versioning guidance — Applied continuous versioning guidance for Groupware apps, helping admins align app version expectations across supported releases. by @backportbot in #14929
- AI Context Chat: vector database log location — Added the vector database log location to improve AI Context Chat troubleshooting guidance. by @kyteinsky in #14818
- Admin manual prose and clarity fixes — Applied low-severity prose and clarity fixes across admin manual pages for smoother reading and more consistent terminology. by @miaulalala in #14701
🧑💻 Developer Manual
- User migration: data preservation — Added a note that user migration implementations should preserve existing user data where appropriate. by @DerDreschner in #14683
IMigratordocumentation — Improved with clearer guidance, better examples, and more explanation of related migration helpers. by @come-nc in #14740- Legacy autoloader removal (Nextcloud 32) — Documented the removal of the legacy autoloader. by @come-nc in #14745
IAppManagerdeprecations and new methods — DocumentedIAppManagerdeprecations and newly available methods in Nextcloud 32. by @come-nc in #14737- Dependency injection chapter — Corrected code examples, expanded the introduction, and clarified several injection patterns. by @joshtrichards in #14707
OC_Responseremoval (Nextcloud 33) — Documented the removal ofOC_Responseand pointed developers to the supported replacement path. by @come-nc in #14755- UX writing guide — Added a UX writing guide for user-facing strings to the design docs. by @backportbot in #14996
- EPUB output for all manuals — Added EPUB output support for all three manuals. by @skjnldsv in #14978
- Sphinx-lint CI and RST fixes — Applied sphinx-lint CI and fixed RST violations across the manual set, improving documentation quality and consistency. by @Copilot in #14814
- Groupware app versioning guidance — Applied continuous versioning guidance for Groupware apps in developer-facing docs. by @backportbot in #14929
- Developer manual prose and markup fixes — Applied medium-severity prose and markup fixes across the developer manual. by @miaulalala in #14703
- Developer manual prose and clarity fixes — Applied low-severity prose and clarity fixes across developer manual pages. by @miaulalala in #14701
👤 User Manual
- Command-line client package names — Updated package names so installation instructions match current naming. by @kesselb in #14688
- Refreshed screenshots and UI descriptions — Refreshed screenshots and accompanying descriptions for a more accurate current UI walkthrough. by @miaulalala in #14759
- WebDAV access documentation — Cleaned up prose and reStructuredText style in the WebDAV access documentation. by @Copilot in #14901
- Groupware user migration capabilities — Added notes so end users better understand what data can move between instances. by @DerDreschner in #14887
- EPUB download output — Added EPUB download output for all three manuals, including the user manual. by @skjnldsv in #14978
- Sphinx-lint CI fixes and RST cleanup — Applied sphinx-lint CI fixes and broader RST cleanup that also improves user manual consistency and formatting. by @Copilot in #14814
- Groupware app versioning guidance — Applied continuous versioning guidance for Groupware apps in user-facing Groupware docs. by @backportbot in #14929
- User manual prose and clarity improvements — Applied medium- and low-severity prose and clarity fixes across user manual pages. by @miaulalala in #14719 and #14701
🎉 Contributors
There were 10 individual contributors to this documentation release. Here are some random shout-outs:
- Thanks @Crizomb for contributing in #14884 🎊
- Thanks @miaulalala for contributing multiple PRs to this release 🎊
- Thanks **[@kessel...
v33.0.3
Nextcloud Documentation v33.0.3
What's Changed
Full Changelog: v33.0.2...v33.0.3
🖥️ Admin Manual
- Installation wizard — Updated to match the current server implementation, including refreshed UI details, setup flow clarifications, and more accurate trusted domain guidance. by @joshtrichards in #14157
- Contacts Interaction app — Added documentation so administrators can understand and configure its functionality. by @ChristophWurst in #14160
- Team membership rules — Clarified how the "Prevent teams from being a member of another team" option behaves so admins can predict team membership more reliably. by @cristianscheid in #14154
- Primary storage — Corrected a typo to avoid confusion about where data is actually stored. by @MartinZeitNextcloud in #14150
occcommand documentation — Fixed stale and inaccurate docs, including clearer command usage, maintenance mode limitations, and antivirus command prerequisites. by @miaulalala in #14338- Upgrade and release schedule docs — Corrected typos across upgrade documentation and release schedule pages. by @miaulalala in #14322
- Admin manual cleanup — Replaced placeholder text with real examples and cleaned up redundant image paths. by @miaulalala in #14330
default_languageconfiguration — Clarified configuration details to better explain language code usage and expected values. by @jameskimmel in #14376- AI Act compliance — Added documentation for AI Act support and related administration concepts. by @marcelklehr in #14170
- System requirements — Corrected the Debian release name typo. by @synq in #14491
- AI worker commands — Updated command documentation so admin guidance matches current command usage. by @marcelklehr in #14513
- Backup documentation — Refined with updated guidance for backup-related administration tasks. by @backportbot in #14543
- Data directory troubleshooting — Refined the write-up to make admin guidance clearer and more accurate. by @joshtrichards in #14613
- Admin manual accuracy fixes — Fixed critical errors to improve accuracy and readability in key sections. by @backportbot in #14617
- Admin manual prose fixes — Fixed high-severity prose errors throughout. by @backportbot in #14621
- Admin manual polish — Applied medium-severity prose quality fixes for clearer, more polished guidance. by @backportbot in #14646
🧑💻 Developer Manual
IConversationOptionsinterface — Added documentation for the new interface so developers can use it correctly. by @nickvergessen in #14265- ContextAgent tools — Documented additional tools to expand the available developer reference material. by @marcelklehr in #14166
- Flow and ExApp docs — Corrected typos for better clarity and accuracy. by @miaulalala in #14320
- XML and reference fixes — Fixed an XML tag mismatch and a broken reference. by @miaulalala in #14324
- Accessibility: image alt text — Added missing alt text to images and figures to improve accessibility. by @miaulalala in #14369
- Backport process documentation — Added backport considerations to clarify when and why backports should be done. by @joshtrichards in #14549
- CSS RTL/LTR guidelines — Added guidelines to help developers write interface styles that work correctly in both text directions. by @hamza221 in #14665
- Developer manual code fixes — Corrected code errors in developer manual examples. by @backportbot in #14622
- Developer manual fixes — Fixed high-severity prose and code errors throughout. by @backportbot in #14623
👤 User Manual
- Talk 23 features — Added documentation for new Talk 23 / Nextcloud 33 features so users can discover and use the latest Talk capabilities. by @Antreesy in #14066
- PDF version output — Fixed PDF output so generated manuals show the actual release version instead of incorrectly saying "latest". by @skjnldsv in #14226
- Live Transcription logs — Added logs view and download information to better explain available user-facing options. by @kyteinsky in #14287
- User preferences: broken link — Removed a self-referential broken link. by @miaulalala in #14318
- User manual typo fixes — Corrected typos and grammar issues across several pages. by @miaulalala in #14316
- Desktop client: x64 and Windows registry — Updated documentation for x64-only builds, including corrected Windows registry keys. by @nilsding in #14327
- DAV:
creationdateproperty — Added to the supported properties table for users and integrators working with DAV clients. by @cristianscheid in #14176 - CalDAV/CardDAV: macOS setup — Updated setup instructions for recent macOS versions. by @jameskimmel in #14163
- Mail: unified search — Documented unified search support in Mail so users can find email content through Nextcloud search. by @ChristophWurst in #14161
- File drop shares — Removed outdated wording about chunked upload behavior to keep file sharing docs accurate. by @DerDreschner in #14331
- Language configuration — Improved documentation with clearer
default_languageguidance relevant to user-facing language behavior. by @jameskimmel in #14376 - Versioned doc links — Automatically replaced
latestlinks for older release docs so versioned manuals point to the correct release-specific pages. by @skjnldsv in #14383 - PHP cache validation — Removed a misleading example that suggested disabling PHP cache validation. by @skjnldsv in #14408
- External storage: delimiter prefixes — Clarified behavior when prefixes contain repeating delimiters. by @leftybournes in #14510
- Windows 10 sync and TLS — Cleaned up Windows 10 sync documentation and documented the TLS 1.2 requirement for CalDAV/CardDAV connectivity. by @skjnldsv in #14618
- Encryption documentation — Removed a contradictory sentence to make the guidance consistent. by @backportbot in #14616
- User manual prose fixes — Fixed high-severity prose errors throughout. by @backportbot in [#14629](https://github.com/nextcloud/...
v33.0.2
What's Changed
- Added last_activity to the supported DAV properties table so clients and integrators can discover the property more easily for CalDAV/CardDAV/WebDAV usage by @cristianscheid in #14174
Full Changelog: v33.0.1...v33.0.2
v33.0.1
Nextcloud Documentation v33.0.1
What's Changed
Full Changelog: v33.0.0...v33.0.1
🖥️ Admin Manual
- Server-side encryption — Major restructure and update of the SSE documentation, improving clarity, accuracy, and completeness. Consolidates troubleshooting entries and expands key management mode details. by @joshtrichards in #14088
- Federated read/write sharing — Added admin documentation covering configuration and management of federated read/write sharing. by @SebastianKrupinski in #14093
- Supported Linux distributions — Updated with current supported distributions, including RHEL 10, Debian 13, SLES 16, and openSUSE Leap 16. by @susnux in #14105
- Recognize app — Updated to avoid incorrect references to the Photos app. by @marcelklehr in #14082
- nginx+php-fpm support — Removed outdated note stating nginx was not officially supported; replaced with a clear statement of support. by @pabzm in #14139
- Windmill integration — Updated to reflect the new Windmill integration model. by @janepie in #14062
- Server tuning — Fixed a typo ("Focking" → "Locking") and a minor grammatical issue. by @o-kotb in #14100
- Remove outdated company statement — Removed an out-of-place company statement. by @susnux in #14118
- Broken and outdated links — Fixed broken and outdated links; added documentation for additional optional weather status servers. by @nickvergessen in #14070
🧑💻 Developer Manual
- OCS documentation refactor — Re-organized for improved readability; modernized and fixed PHP code snippets with minor technical clarifications. by @joshtrichards in #14104
- TaskProcessing upgrade guide — Added TaskProcessing API changes to the Nextcloud 33 upgrade guide. by @marcelklehr in #14048
- DAV:
upload_timeproperty — Addedupload_timeto the supported DAV properties table. by @cristianscheid in #14077 - Broken and outdated links — Fixed broken and outdated links including removal of expired author profiles. by @nickvergessen in #14070
👤 User Manual
- Federated read/write sharing — Added user-facing documentation describing how to use federated read/write sharing. by @SebastianKrupinski in #14093
- Mail: Improved quick action documentation — Clarified how and where to use quick actions in the Nextcloud Mail app. by @DerDreschner in #14108
- Mail: Revert GIF for quick actions — Reverted the introduction of a GIF in the mail quick actions section that was causing build failures. by @DerDreschner in #14135
🎉 New Contributors
Note: All PRs in this release are backports to the
stable33branch via @backportbot. Original authors and their contributions are credited above.
v33.0.1rc1
Nextcloud Documentation v33.0.1rc1
What's Changed
Full Changelog: v33.0.0...v33.0.1rc1
🖥️ Admin Manual
- Server-side encryption — Major restructure and update of the SSE documentation, improving clarity, accuracy, and completeness. Consolidates troubleshooting entries and expands key management mode details. by @joshtrichards in #14088
- Federated read/write sharing — Added admin documentation covering configuration and management of federated read/write sharing. by @SebastianKrupinski in #14093
- Supported Linux distributions — Updated with current supported distributions, including RHEL 10, Debian 13, SLES 16, and openSUSE Leap 16. by @susnux in #14105
- Recognize app — Updated to avoid incorrect references to the Photos app. by @marcelklehr in #14082
- nginx+php-fpm support — Removed outdated note stating nginx was not officially supported; replaced with a clear statement of support. by @pabzm in #14139
- Windmill integration — Updated to reflect the new Windmill integration model. by @janepie in #14062
- Server tuning — Fixed a typo ("Focking" → "Locking") and a minor grammatical issue. by @o-kotb in #14100
- Remove outdated company statement — Removed an out-of-place company statement. by @susnux in #14118
- Broken and outdated links — Fixed broken and outdated links; added documentation for additional optional weather status servers. by @nickvergessen in #14070
🧑💻 Developer Manual
- OCS documentation refactor — Re-organized for improved readability; modernized and fixed PHP code snippets with minor technical clarifications. by @joshtrichards in #14104
- TaskProcessing upgrade guide — Added TaskProcessing API changes to the Nextcloud 33 upgrade guide. by @marcelklehr in #14048
- DAV:
upload_timeproperty — Addedupload_timeto the supported DAV properties table. by @cristianscheid in #14077 - Broken and outdated links — Fixed broken and outdated links including removal of expired author profiles. by @nickvergessen in #14070
👤 User Manual
- Federated read/write sharing — Added user-facing documentation describing how to use federated read/write sharing. by @SebastianKrupinski in #14093
- Mail: Improved quick action documentation — Clarified how and where to use quick actions in the Nextcloud Mail app. by @DerDreschner in #14108
- Mail: Revert GIF for quick actions — Reverted the introduction of a GIF in the mail quick actions section that was causing build failures. by @DerDreschner in #14135
🎉 New Contributors
Note: All PRs in this release are backports to the
stable33branch via @backportbot. Original authors and their contributions are credited above.
v33.0.0
What's Changed
User Manual
- Mail & Groupware:
- Added a separate section for mail troubleshooting, removed mail shortcuts, and reorganized related content (#14001, thanks @DerDreschner).
- Appointments:
- Added documentation for automated appointment creation (#14015, via @backportbot[bot]).
Admin Manual
- Mail Troubleshooting:
- Created a dedicated troubleshooting section for Mail and improved admin documentation organization (#14001, thanks @DerDreschner).
- Database Support:
- AI / Live Transcription:
- Added documentation for live translation features (#14049, via @backportbot[bot]).
- Context Chat:
- Updated scaling documentation for parsing in AI Context Chat (#14053, via @backportbot[bot]).
- Sustainability:
- Added information about energy consumption (#14060, via @backportbot[bot]).
- Release Notes & S3:
- Clarified in release notes that S3 integrity protection is now opt-in (#14043, via @backportbot[bot]).
Developer Manual
- Database:
- Updated documentation to port away from the deprecated
createFunction(#14013, via @backportbot[bot]).
- Updated documentation to port away from the deprecated
- Feature Removals:
- Documented the removal of the “What’s New” feature (#14042, via @backportbot[bot]).
General Documentation
- Code Examples:
- Improved integration of code examples for clarity (#13994, thanks @piechocki).
- Docs Navigation:
- Fixed documentation links to ensure users stay in the selected version 33 (#14028, thanks @nickvergessen).
Infrastructure
- CI:
- Continuous integration actions are now pinned for improved reliability (#14031, via @backportbot[bot]).
New Contributors
- @piechocki made their first contribution (#13994)
Full Changelog:
v33.0.0beta5...v33.0.0
v33.0.0rc4
What's Changed
Admin Manual
- AI / Live Transcription:
- Added documentation for live translation features in Live Transcription (#14049, via @backportbot[bot]).
- Context Chat:
- Updated scaling documentation for parsing in AI Context Chat (#14053, via @backportbot[bot]).
- Sustainability:
- Added information about energy consumption (#14060, via @backportbot[bot]).
Full Changelog:
v33.0.0rc3...v33.0.0rc4
v32.0.6
What's Changed
User Manual
- Mail App: User documentation for the Mail app has been moved out of the mail repository and updated (#14002, via @backportbot[bot]).
- Groupware – Contacts: Legacy contacts troubleshooting documentation is now consolidated under Groupware (#14006, via @backportbot[bot]).
- Calendar: Calendar invitation participants can now be restricted (#13989, via @backportbot[bot]).
- Appointments: Documentation for automated appointment creation (#14014, via @backportbot[bot]).
Admin Manual
- Mail App: Admin documentation for the Mail app moved and debug logging section updated (#14002, via @backportbot[bot]).
- Release Notes/Configuration: S3 integrity protection is now opt-in (#14044, via @backportbot[bot]).
- AI/Live Transcription: Resource requirements for AI-powered live transcription added (#14050, thanks @kyteinsky).
- Energy Efficiency: Added information about energy consumption (#14059, via @backportbot[bot]).
Developer Manual
- (No direct developer manual changes included in this release cycle.)
Infrastructure & General Docs Improvements
- Code Integration: General fixes and improvements to code/documentation consistency (#14003, via @backportbot[bot]).
- CI: Continuous Integration (CI) actions pinned for reliability (#14030, via @backportbot[bot]).
Full Changelog:
v32.0.5...v32.0.6