feat(ExternalStorage) Allow the use of 'prefix' in S3 buckets#15222
feat(ExternalStorage) Allow the use of 'prefix' in S3 buckets#15222mbartsch wants to merge 1 commit into
Conversation
Signed-off-by: Marcelo H. Bartsch <marcelo@bartsch.cl>
|
Hello there, We hope that the review process is going smooth and is helpful for you. We want to ensure your pull request is reviewed to your satisfaction. If you have a moment, our community management team would very much appreciate your feedback on your experience with this PR review process. Your feedback is valuable to us as we continuously strive to improve our community developer experience. Please take a moment to complete our short survey by clicking on the following link: https://cloud.nextcloud.com/apps/forms/s/i9Ago4EQRZ7TWxjfmeEpPkf6 Thank you for contributing to Nextcloud and we hope to hear from you soon! (If you believe you should not receive this message, you can add yourself to the blocklist.) |
☑️ Resolves
🖼️ Screenshots
Before — no prefix field mentioned in the S3 external storage documentation.
After — new section between the Bucket and Access key fields:
In the Bucket field enter your S3 bucket name. [...]
The optional Object key prefix field scopes the mount to a sub-path within
the bucket rather than using the entire bucket. For example, setting the prefix
to
nextcloud/will store all files under thenextcloud/key namespaceinside the bucket, leaving the rest of the bucket untouched. This is useful
when a bucket is shared between multiple services or Nextcloud instances.
.. note::
The prefix is automatically normalized: leading slashes are stripped and a
trailing slash is always added.
myapp,myapp/, and/myapp/areall equivalent.
.. tip::
The
$userplaceholder is supported in the prefix field and is substitutedwith the Nextcloud username at mount time. For example, setting the prefix to
nextcloud/$user/will store each user's files under their own namespace(e.g.
nextcloud/alice/for useralice). This is particularly usefulfor global mounts shared across all users.
In the Access key field enter your S3 access key ID.
✅ Checklist
Assisted-by: CloudeCode:claude-sonnet-4-6