mirror of
https://github.com/nextcloud/documentation.git
synced 2025-10-26 11:18:02 +00:00
Remove unmaintained & outdated documentation
Signed-off-by: Marius Blüm <marius@lineone.io>
This commit is contained in:
parent
32241b6693
commit
4ed2d87704
@ -5,15 +5,14 @@ File Sharing and Management
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 2
|
||||
|
||||
|
||||
file_sharing_configuration
|
||||
federated_cloud_sharing_configuration
|
||||
big_file_upload_configuration
|
||||
default_files_configuration
|
||||
default_files_configuration
|
||||
external_storage_configuration_gui
|
||||
external_storage_configuration
|
||||
external_storage/auth_mechanisms
|
||||
primary_storage
|
||||
encryption_configuration
|
||||
files_locking_transactional
|
||||
previews_configuration
|
||||
|
||||
@ -1,136 +0,0 @@
|
||||
===========================
|
||||
Primary Storage
|
||||
===========================
|
||||
|
||||
It's possible to use an object store as primary storage, this replaces the default
|
||||
way of storing files in :code:`nextcloud/data` (note that the data directory might still be used
|
||||
for other reasons)
|
||||
|
||||
---------------------------
|
||||
Implications
|
||||
---------------------------
|
||||
|
||||
When using an object store as primary storage, Nextcloud assumes exclusive access
|
||||
over the bucket being used.
|
||||
|
||||
Contrary to using an object store as external storage, when an object store is used
|
||||
as primary storage, no metadata (names, directory structures, etc) is stored in the
|
||||
object store. The metadata is only stored in the database and the object store only
|
||||
holds the file content by unique identifier.
|
||||
|
||||
Because of this primary object stores usually perform better than when using the same
|
||||
object store as external storage but it restricts being able to access the files from
|
||||
outside of Nextcloud.
|
||||
|
||||
---------------------------
|
||||
Configuring
|
||||
---------------------------
|
||||
|
||||
Primary object stores need to be configured in :code:`config.php` by specifying the objectstore
|
||||
backend and any backend specific configuration.
|
||||
|
||||
.. note:: Configuring a primary object store on an existing Nextcloud instance will
|
||||
make all existing files on the instance inaccessible.
|
||||
|
||||
The configuration has the following structure.
|
||||
|
||||
::
|
||||
|
||||
'objectstore' => array(
|
||||
'class' => 'Object\\Storage\\Backend\\Class',
|
||||
'arguments' => array(
|
||||
...
|
||||
),
|
||||
),
|
||||
|
||||
~~~~~~~~~~~~~~~
|
||||
Openstack Swift
|
||||
~~~~~~~~~~~~~~~
|
||||
|
||||
The Swift backend mounts a container on an OpenStack Object Storage server into the virtual filesystem. The class to be used is :code:`\\OC\\Files\\ObjectStore\\Swift`
|
||||
|
||||
::
|
||||
|
||||
'objectstore' => array(
|
||||
'class' => 'OC\\Files\\ObjectStore\\Swift',
|
||||
'arguments' => array(
|
||||
'username' => 'username',
|
||||
'password' => 'Secr3tPaSSWoRdt7',
|
||||
// the container to store the data in
|
||||
'bucket' => 'nextcloud',
|
||||
'autocreate' => true,
|
||||
'region' => 'RegionOne',
|
||||
// The Identity / Keystone endpoint
|
||||
'url' => 'http://example.com/v2.0',
|
||||
// optional on some swift implementations
|
||||
'tenantName' => 'username',
|
||||
'serviceName' => 'swift',
|
||||
// The Interface / url Type, optional
|
||||
'urlType' => 'internal'
|
||||
),
|
||||
),
|
||||
|
||||
---------
|
||||
Amazon S3
|
||||
---------
|
||||
|
||||
The S3 backend mounts a bucket on an Amazon S3 Storage or compatible server into the virtual filesystem. The class to be used is :code:`\\OC\\Files\\ObjectStore\\S3`
|
||||
|
||||
::
|
||||
|
||||
'objectstore' => array(
|
||||
'class' => 'OC\\Files\\ObjectStore\\S3',
|
||||
'arguments' => array(
|
||||
'bucket' => 'nextcloud',
|
||||
'autocreate' => true,
|
||||
'key' => 'EJ39ITYZEUH5BGWDRUFY',
|
||||
'secret' => 'M5MrXTRjkyMaxXPe2FRXMTfTfbKEnZCu+7uRTVSj',
|
||||
'hostname' => 'example.com',
|
||||
'port' => 1234,
|
||||
'use_ssl' => true,
|
||||
'region' => 'optional',
|
||||
// required for some non amazon s3 implementations
|
||||
'use_path_style' => true,
|
||||
'legacy_auth' => false
|
||||
),
|
||||
),
|
||||
|
||||
Not all configuration options are required for all S3 servers.
|
||||
Overriding the hostname, port and region of your S3 server is only
|
||||
required for non-Amazon servers such as Ceph Object Gateway, which in turn
|
||||
usually don't require the region to be set.
|
||||
|
||||
:code:`use_path_style` is usually not required (and is, in fact, incompatible with newer Amazon datacenters),
|
||||
but can be used with non-Amazon servers where the DNS infrastructure cannot be controlled. Ordinarily,
|
||||
requests will be made with http://bucket.hostname.domain/, but with path style enabled,
|
||||
requests are made with http://hostname.domain/bucket instead.
|
||||
|
||||
:code:`legacy_auth` is only required for S3 servers that only implement version 2 authentication,
|
||||
on default version 4 authentication will be used.
|
||||
|
||||
---------------------------
|
||||
Multibucket Object Store
|
||||
---------------------------
|
||||
|
||||
It's possible to configure Nextcloud to distribute it's data over multiple buckets for scalability purpose.
|
||||
|
||||
To setup multiple buckets, :code:`config.php` needs to be configured using :code:`'objectstore_multibucket'`
|
||||
|
||||
::
|
||||
|
||||
'objectstore_multibucket' => array(
|
||||
'class' => 'Object\\Storage\\Backend\\Class',
|
||||
'arguments' => array(
|
||||
// optional, defaults to 64
|
||||
'num_buckets' => 64,
|
||||
// will be prefixed by an integer in the range from 0 to (num_nuckets-1)
|
||||
'bucket' => 'nextcloud_',
|
||||
...
|
||||
),
|
||||
),
|
||||
|
||||
Nextcloud will map every user to a range of buckets and save all files for that user in it's respective bucket.
|
||||
|
||||
.. note:: Changing the number of buckets for an existing Nextcloud instance is supported but the
|
||||
mapping from users to buckets is persistent so only newly created users will be mapped to the
|
||||
updated range of buckets.
|
||||
@ -1,27 +0,0 @@
|
||||
===================================
|
||||
Custom Client Download Repositories
|
||||
===================================
|
||||
|
||||
You may configure the URLs to your own download repositories for your Nextcloud
|
||||
desktop clients and mobile apps in :file:`config/config.php`. This example shows
|
||||
the default download locations:
|
||||
|
||||
::
|
||||
|
||||
<?php
|
||||
|
||||
"customclient_desktop" => "https://nextcloud.com/install/",
|
||||
"customclient_android" => "https://play.google.com/store/apps/details?id=com.nextcloud.client",
|
||||
"customclient_ios" => "https://itunes.apple.com/us/app/nextcloud/id1125420102?mt=8",
|
||||
|
||||
Simply replace the URLs with the links to your own preferred download repos.
|
||||
|
||||
You may test alternate URLs without editing :file:`config/config.php` by setting a test URL as an environment variable::
|
||||
|
||||
export OCC_UPDATE_URL=https://test.example.com
|
||||
|
||||
When you're finished testing you can disable the environment variable::
|
||||
|
||||
unset OCC_UPDATE_URL
|
||||
|
||||
|
||||
@ -8,18 +8,15 @@ Server Configuration
|
||||
security_setup_warnings
|
||||
occ_command
|
||||
activity_configuration
|
||||
sso_configuration
|
||||
caching_configuration
|
||||
background_jobs_configuration
|
||||
background_jobs_configuration
|
||||
config_sample_php_parameters
|
||||
email_configuration
|
||||
external_sites
|
||||
custom_client_repos
|
||||
knowledgebase_configuration
|
||||
language_configuration
|
||||
logging_configuration
|
||||
harden_server
|
||||
reverse_proxy_configuration
|
||||
reverse_proxy_configuration
|
||||
thirdparty_php_configuration
|
||||
automatic_configuration
|
||||
server_tuning
|
||||
|
||||
Binary file not shown.
|
Before Width: | Height: | Size: 23 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 12 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 13 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 35 KiB |
Binary file not shown.
|
Before Width: | Height: | Size: 14 KiB |
@ -1,13 +0,0 @@
|
||||
==========
|
||||
Operations
|
||||
==========
|
||||
|
||||
Advanced operation including monitoring, scaling across multiple machines, and
|
||||
creating a custom theme for your Nextcloud server.
|
||||
|
||||
.. toctree::
|
||||
:maxdepth: 2
|
||||
|
||||
considerations_on_monitoring
|
||||
scaling_multiple_machines.rst
|
||||
|
||||
Loading…
Reference in New Issue
Block a user