khanh.pndc/nextcloud-docs
1
0
Fork 0
mirror of https://github.com/nextcloud/documentation.git synced 2025-12-12 07:29:47 +07:00
Code Issues Packages Projects Releases Wiki Activity

add documentation for multi-instance primary object storage

Browse Source 
Signed-off-by: Robin Appelman <robin@icewind.nl>
This commit is contained in:
Robin Appelman
2025-11-20 16:24:08 +01:00
parent 842cde091d
commit 369d8fcbb7
1 changed files with 55 additions and 3 deletions
Download Patch File Download Diff File Expand all files Collapse all files

58
admin_manual/configuration_files/primary_storage.rst
View File

@@ -244,14 +244,15 @@ Multibucket Object Store
It's possible to configure Nextcloud to distribute the data over multiple buckets
for scalability purposes.
To setup multiple buckets, use :code:`'objectstore_multibucket'` storage backend
in :code:`config.php`:
To setup multiple buckets, set :code:`'multibucket => true'` in the object store
configuration in :code:`config.php`:
::
'objectstore_multibucket' => [
'objectstore' => [
'class' => 'Object\\Storage\\Backend\\Class',
'arguments' => [
'multibucket' => true,
// optional, defaults to 64
'num_buckets' => 64,
// will be postfixed by an integer in the range from 0 to (num_nuckets-1)
@@ -271,6 +272,57 @@ You can find out more information about upscaling with object storage and Nextcl
`Nextcloud customer portal <https://portal.nextcloud.com/article/object-store-as-primary-storage-16.html>`_.
---------------------------
Multi-instance Object Store
---------------------------
It's possible to configure Nextcloud to distribute the data over multiple object store
instances for further scaling and gradual migration.
To setup multiple buckets, set :code:`'objectstore'` to an array of named configurations
configuration in :code:`config.php` and set the :code:`'default'` to the name of the
configuration to use for newly created users:
::
'objectstore' => [
'default' => 'server2',
'root' => 'server1',
'server1' => [
'class' => 'Object\\Storage\\Backend\\Class',
'arguments' => [
'hostname' => 's3-server1.example.com',
'bucket' => 's1_nextcloud',
...
],
],
'server2' => [
'class' => 'Object\\Storage\\Backend\\Class',
'arguments' => [
'multibucket' => true,
'hostname' => 's3-server2.example.com',
'bucket' => 's2_nextcloud_',
...
],
],
],
.. note:: Bucket names must be unique between all configured object store instances.
Newly created users will be mapped to the object store instance set in :code:`default`.
Files that are not part of the users storage are put in the :code:`root` instance, or
in the :code:`default` instance if no :code:`root` instance is configured.
In the above example, if :code:`server2` is starting to run low on capacity, an admin can
setup and configure a new :code:`server3` and change the :code:`default` to :code:`server3`.
Than any newly created user will have their files put on :code:`server3`.
.. note:: As with multibucket object store, the user-to-instance mapping is only created once,
so only newly created users will be mapped to the new default instance.
It is possible to mix different object store backends and multibucket and non-multibucket in
a multi-instance configuration.
---------------------------
S3 SSE-C encryption support
---------------------------