Configuration

Configuration

Configuration using config files

Out of the box extensions will attempt to read configuration details from:

/etc/ocis
$HOME/.ocis
./config

For this configuration to be picked up, have a look at your extension root command and look for which default config name it has assigned. i.e: ocis-proxy reads proxy.json | yaml | toml ....

So far we support the file formats JSON and YAML, if you want to get a full example configuration just take a look at our repository, there you can always see the latest configuration format. These example configurations include all available options and the default values. The configuration file will be automatically loaded if it’s placed at /etc/ocis/ocis.yml, ${HOME}/.ocis/ocis.yml or $(pwd)/config/ocis.yml.

Environment variables

If you prefer to configure the service with environment variables you can see the available variables below.

If multiple variables are listed for one option, they are in order of precedence. This means the leftmost variable will always win if given.

Commandline flags

If you prefer to configure the service with commandline flags you can see the available variables below. Command line flags are only working when calling the subcommand directly.

Root Command

Storage service for oCIS

Usage: storage [global options] command [command options] [arguments...]

-config-file | $STORAGE_CONFIG_FILE
Path to config file.
-log-level | $STORAGE_LOG_LEVEL , $OCIS_LOG_LEVEL
Set logging level.
-log-pretty | $STORAGE_LOG_PRETTY , $OCIS_LOG_PRETTY
Enable pretty logging.
-log-color | $STORAGE_LOG_COLOR , $OCIS_LOG_COLOR
Enable colored logging.

Sub Commands

storage users

Start users service

Usage: storage users [command options] [arguments...]

-debug-addr | $STORAGE_SHARING_DEBUG_ADDR
Address to bind debug server. Default: flags.OverrideDefaultString(cfg.Reva.Users.DebugAddr, "0.0.0.0:9145").
-network | $STORAGE_USERPROVIDER_NETWORK
Network to use for the storage service, can be ‘tcp’, ‘udp’ or ‘unix’. Default: flags.OverrideDefaultString(cfg.Reva.Users.GRPCNetwork, "tcp").
-addr | $STORAGE_USERPROVIDER_ADDR
Address to bind storage service. Default: flags.OverrideDefaultString(cfg.Reva.Users.GRPCAddr, "0.0.0.0:9144").
-endpoint | $STORAGE_USERPROVIDER_ENDPOINT
URL to use for the storage service. Default: flags.OverrideDefaultString(cfg.Reva.Users.Endpoint, "localhost:9144").
-driver | $STORAGE_USERPROVIDER_DRIVER
user driver: ‘demo’, ‘json’, ‘ldap’, or ‘rest’. Default: flags.OverrideDefaultString(cfg.Reva.Users.Driver, "ldap").
-json-config | $STORAGE_USERPROVIDER_JSON
Path to users.json file. Default: flags.OverrideDefaultString(cfg.Reva.Users.JSON, "").

storage auth-basic

Start authprovider for basic auth

Usage: storage auth-basic [command options] [arguments...]

-debug-addr | $STORAGE_AUTH_BASIC_DEBUG_ADDR
Address to bind debug server. Default: flags.OverrideDefaultString(cfg.Reva.AuthBasic.DebugAddr, "0.0.0.0:9147").
-auth-driver | $STORAGE_AUTH_DRIVER
auth driver: ‘demo’, ‘json’ or ‘ldap’. Default: flags.OverrideDefaultString(cfg.Reva.AuthProvider.Driver, "ldap").
-auth-json | $STORAGE_AUTH_JSON
Path to users.json file. Default: flags.OverrideDefaultString(cfg.Reva.AuthProvider.JSON, "").
-network | $STORAGE_AUTH_BASIC_GRPC_NETWORK
Network to use for the storage auth-basic service, can be ‘tcp’, ‘udp’ or ‘unix’. Default: flags.OverrideDefaultString(cfg.Reva.AuthBasic.GRPCNetwork, "tcp").
-addr | $STORAGE_AUTH_BASIC_GRPC_ADDR
Address to bind storage service. Default: flags.OverrideDefaultString(cfg.Reva.AuthBasic.GRPCAddr, "0.0.0.0:9146").
-gateway-url | $STORAGE_GATEWAY_ENDPOINT
URL to use for the storage gateway service. Default: flags.OverrideDefaultString(cfg.Reva.Gateway.Endpoint, "localhost:9142").

storage auth-bearer

Start authprovider for bearer auth

Usage: storage auth-bearer [command options] [arguments...]

-debug-addr | $STORAGE_AUTH_BEARER_DEBUG_ADDR
Address to bind debug server. Default: flags.OverrideDefaultString(cfg.Reva.AuthBearer.DebugAddr, "0.0.0.0:9149").
-oidc-issuer | $STORAGE_OIDC_ISSUER , $OCIS_URL
OIDC issuer. Default: flags.OverrideDefaultString(cfg.Reva.OIDC.Issuer, "https://localhost:9200").
-oidc-insecure | $STORAGE_OIDC_INSECURE
OIDC allow insecure communication. Default: flags.OverrideDefaultBool(cfg.Reva.OIDC.Insecure, true).
-oidc-id-claim | $STORAGE_OIDC_ID_CLAIM
OIDC id claim. Default: flags.OverrideDefaultString(cfg.Reva.OIDC.IDClaim, "preferred_username").
-oidc-uid-claim | $STORAGE_OIDC_UID_CLAIM
OIDC uid claim. Default: flags.OverrideDefaultString(cfg.Reva.OIDC.UIDClaim, "").
-oidc-gid-claim | $STORAGE_OIDC_GID_CLAIM
OIDC gid claim. Default: flags.OverrideDefaultString(cfg.Reva.OIDC.GIDClaim, "").
-network | $STORAGE_AUTH_BEARER_GRPC_NETWORK
Network to use for the storage service, can be ‘tcp’, ‘udp’ or ‘unix’. Default: flags.OverrideDefaultString(cfg.Reva.AuthBearer.GRPCNetwork, "tcp").
-addr | $STORAGE_AUTH_BEARER_GRPC_ADDR
Address to bind storage service. Default: flags.OverrideDefaultString(cfg.Reva.AuthBearer.GRPCAddr, "0.0.0.0:9148").
-gateway-url | $STORAGE_GATEWAY_ENDPOINT
URL to use for the storage gateway service. Default: flags.OverrideDefaultString(cfg.Reva.Gateway.Endpoint, "localhost:9142").

storage frontend

Start frontend service

Usage: storage frontend [command options] [arguments...]

-debug-addr | $STORAGE_FRONTEND_DEBUG_ADDR
Address to bind debug server. Default: flags.OverrideDefaultString(cfg.Reva.Frontend.DebugAddr, "0.0.0.0:9141").
-transfer-secret | $STORAGE_TRANSFER_SECRET
Transfer secret for datagateway. Default: flags.OverrideDefaultString(cfg.Reva.TransferSecret, "replace-me-with-a-transfer-secret").
-webdav-namespace | $STORAGE_WEBDAV_NAMESPACE
Namespace prefix for the /webdav endpoint. Default: flags.OverrideDefaultString(cfg.Reva.OCDav.WebdavNamespace, "/home/").
-dav-files-namespace | $STORAGE_DAV_FILES_NAMESPACE
Namespace prefix for the webdav /dav/files endpoint. Default: flags.OverrideDefaultString(cfg.Reva.OCDav.DavFilesNamespace, "/users/").
-network | $STORAGE_FRONTEND_HTTP_NETWORK
Network to use for the storage service, can be ‘tcp’, ‘udp’ or ‘unix’. Default: flags.OverrideDefaultString(cfg.Reva.Frontend.HTTPNetwork, "tcp").
-addr | $STORAGE_FRONTEND_HTTP_ADDR
Address to bind storage service. Default: flags.OverrideDefaultString(cfg.Reva.Frontend.HTTPAddr, "0.0.0.0:9140").
-public-url | $STORAGE_FRONTEND_PUBLIC_URL , $OCIS_URL
URL to use for the storage service. Default: flags.OverrideDefaultString(cfg.Reva.Frontend.PublicURL, "https://localhost:9200").
-datagateway-prefix | $STORAGE_FRONTEND_DATAGATEWAY_PREFIX
datagateway prefix. Default: flags.OverrideDefaultString(cfg.Reva.Frontend.DatagatewayPrefix, "data").
-ocdav-prefix | $STORAGE_FRONTEND_OCDAV_PREFIX
owncloud webdav endpoint prefix. Default: flags.OverrideDefaultString(cfg.Reva.Frontend.OCDavPrefix, "").
-ocs-prefix | $STORAGE_FRONTEND_OCS_PREFIX
open collaboration services endpoint prefix. Default: flags.OverrideDefaultString(cfg.Reva.Frontend.OCSPrefix, "ocs").
-ocs-share-prefix | $STORAGE_FRONTEND_OCS_SHARE_PREFIX
the prefix prepended to the path of shared files. Default: flags.OverrideDefaultString(cfg.Reva.Frontend.OCSSharePrefix, "/Shares").
-ocs-home-namespace | $STORAGE_FRONTEND_OCS_HOME_NAMESPACE
the prefix prepended to the incoming requests in OCS. Default: flags.OverrideDefaultString(cfg.Reva.Frontend.OCSHomeNamespace, "/home").
-gateway-url | $STORAGE_GATEWAY_ENDPOINT
URL to use for the storage gateway service. Default: flags.OverrideDefaultString(cfg.Reva.Gateway.Endpoint, "localhost:9142").
-default-upload-protocol | $STORAGE_FRONTEND_DEFAULT_UPLOAD_PROTOCOL
Default upload chunking protocol to be used out of tus/v1/ng. Default: flags.OverrideDefaultString(cfg.Reva.DefaultUploadProtocol, "tus").
-upload-http-method-override | $STORAGE_FRONTEND_UPLOAD_HTTP_METHOD_OVERRIDE
Specify an HTTP method (ex: POST) that clients should to use when uploading instead of PATCH. Default: flags.OverrideDefaultString(cfg.Reva.UploadHTTPMethodOverride, "").
-checksum-preferred-upload-type | $STORAGE_FRONTEND_CHECKSUM_PREFERRED_UPLOAD_TYPE
Specify the preferred checksum algorithm used for uploads. Default: flags.OverrideDefaultString(cfg.Reva.ChecksumPreferredUploadType, "").

storage storage-home

Start storage-home service

Usage: storage storage-home [command options] [arguments...]

-debug-addr | $STORAGE_HOME_DEBUG_ADDR
Address to bind debug server. Default: flags.OverrideDefaultString(cfg.Reva.StorageHome.DebugAddr, "0.0.0.0:9156").
-grpc-network | $STORAGE_HOME_GRPC_NETWORK
Network to use for the storage service, can be ‘tcp’, ‘udp’ or ‘unix’. Default: flags.OverrideDefaultString(cfg.Reva.StorageHome.GRPCNetwork, "tcp").
-grpc-addr | $STORAGE_HOME_GRPC_ADDR
Address to bind storage service. Default: flags.OverrideDefaultString(cfg.Reva.StorageHome.GRPCAddr, "0.0.0.0:9154").
-http-network | $STORAGE_HOME_HTTP_NETWORK
Network to use for the storage service, can be ‘tcp’, ‘udp’ or ‘unix’. Default: flags.OverrideDefaultString(cfg.Reva.StorageHome.HTTPNetwork, "tcp").
-http-addr | $STORAGE_HOME_HTTP_ADDR
Address to bind storage service. Default: flags.OverrideDefaultString(cfg.Reva.StorageHome.HTTPAddr, "0.0.0.0:9155").
-driver | $STORAGE_HOME_DRIVER
storage driver for home mount: eg. local, eos, owncloud, ocis or s3. Default: flags.OverrideDefaultString(cfg.Reva.StorageHome.Driver, "ocis").
-mount-path | $STORAGE_HOME_MOUNT_PATH
mount path. Default: flags.OverrideDefaultString(cfg.Reva.StorageHome.MountPath, "/home").
-mount-id | $STORAGE_HOME_MOUNT_ID
mount id. Default: flags.OverrideDefaultString(cfg.Reva.StorageHome.MountID, "1284d238-aa92-42ce-bdc4-0b0000009157").
-expose-data-server | $STORAGE_HOME_EXPOSE_DATA_SERVER
exposes a dedicated data server. Default: flags.OverrideDefaultBool(cfg.Reva.StorageHome.ExposeDataServer, false).
-data-server-url | $STORAGE_HOME_DATA_SERVER_URL
data server url. Default: flags.OverrideDefaultString(cfg.Reva.StorageHome.DataServerURL, "http://localhost:9155/data").
-http-prefix | $STORAGE_HOME_HTTP_PREFIX
prefix for the http endpoint, without leading slash. Default: flags.OverrideDefaultString(cfg.Reva.StorageHome.HTTPPrefix, "data").
-tmp-folder | $STORAGE_HOME_TMP_FOLDER
path to tmp folder. Default: flags.OverrideDefaultString(cfg.Reva.StorageHome.TempFolder, "/var/tmp/ocis/tmp/home").
-enable-home | $STORAGE_HOME_ENABLE_HOME
enable the creation of home directories. Default: flags.OverrideDefaultBool(cfg.Reva.Storages.Home.EnableHome, true).
-gateway-endpoint | $STORAGE_GATEWAY_ENDPOINT
endpoint to use for the storage gateway service. Default: flags.OverrideDefaultString(cfg.Reva.Gateway.Endpoint, "localhost:9142").
-users-endpoint | $STORAGE_USERPROVIDER_ENDPOINT
endpoint to use for the storage service. Default: flags.OverrideDefaultString(cfg.Reva.Users.Endpoint, "localhost:9144").

Start storage-public-link service

Usage: storage storage-public-link [command options] [arguments...]

-debug-addr | $STORAGE_PUBLIC_LINK_DEBUG_ADDR
Address to bind debug server. Default: flags.OverrideDefaultString(cfg.Reva.StoragePublicLink.DebugAddr, "0.0.0.0:9179").
-network | $STORAGE_PUBLIC_LINK_GRPC_NETWORK
Network to use for the storage service, can be ‘tcp’, ‘udp’ or ‘unix’. Default: flags.OverrideDefaultString(cfg.Reva.StoragePublicLink.GRPCNetwork, "tcp").
-addr | $STORAGE_PUBLIC_LINK_GRPC_ADDR
Address to bind storage service. Default: flags.OverrideDefaultString(cfg.Reva.StoragePublicLink.GRPCAddr, "0.0.0.0:9178").
-mount-path | $STORAGE_PUBLIC_LINK_MOUNT_PATH
mount path. Default: flags.OverrideDefaultString(cfg.Reva.StoragePublicLink.MountPath, "/public").
-gateway-endpoint | $STORAGE_GATEWAY_ENDPOINT
endpoint to use for the storage gateway service. Default: flags.OverrideDefaultString(cfg.Reva.Gateway.Endpoint, "localhost:9142").

storage storage-users

Start storage-users service

Usage: storage storage-users [command options] [arguments...]

-debug-addr | $STORAGE_USERS_DEBUG_ADDR
Address to bind debug server. Default: flags.OverrideDefaultString(cfg.Reva.StorageUsers.DebugAddr, "0.0.0.0:9159").
-grpc-network | $STORAGE_USERS_GRPC_NETWORK
Network to use for the users storage, can be ‘tcp’, ‘udp’ or ‘unix’. Default: flags.OverrideDefaultString(cfg.Reva.StorageUsers.GRPCNetwork, "tcp").
-grpc-addr | $STORAGE_USERS_GRPC_ADDR
GRPC Address to bind users storage. Default: flags.OverrideDefaultString(cfg.Reva.StorageUsers.GRPCAddr, "0.0.0.0:9157").
-http-network | $STORAGE_USERS_HTTP_NETWORK
Network to use for the storage service, can be ‘tcp’, ‘udp’ or ‘unix’. Default: flags.OverrideDefaultString(cfg.Reva.StorageUsers.HTTPNetwork, "tcp").
-http-addr | $STORAGE_USERS_HTTP_ADDR
HTTP Address to bind users storage. Default: flags.OverrideDefaultString(cfg.Reva.StorageUsers.HTTPAddr, "0.0.0.0:9158").
-driver | $STORAGE_USERS_DRIVER
storage driver for users mount: eg. local, eos, owncloud, ocis or s3. Default: flags.OverrideDefaultString(cfg.Reva.StorageUsers.Driver, "ocis").
-mount-path | $STORAGE_USERS_MOUNT_PATH
mount path. Default: flags.OverrideDefaultString(cfg.Reva.StorageUsers.MountPath, "/users").
-mount-id | $STORAGE_USERS_MOUNT_ID
mount id. Default: flags.OverrideDefaultString(cfg.Reva.StorageUsers.MountID, "1284d238-aa92-42ce-bdc4-0b0000009157").
-expose-data-server | $STORAGE_USERS_EXPOSE_DATA_SERVER
exposes a dedicated data server. Default: flags.OverrideDefaultBool(cfg.Reva.StorageUsers.ExposeDataServer, false).
-data-server-url | $STORAGE_USERS_DATA_SERVER_URL
data server url. Default: flags.OverrideDefaultString(cfg.Reva.StorageUsers.DataServerURL, "http://localhost:9158/data").
-http-prefix | $STORAGE_USERS_HTTP_PREFIX
prefix for the http endpoint, without leading slash. Default: flags.OverrideDefaultString(cfg.Reva.StorageUsers.HTTPPrefix, "data").
-tmp-folder | $STORAGE_USERS_TMP_FOLDER
path to tmp folder. Default: flags.OverrideDefaultString(cfg.Reva.StorageUsers.TempFolder, "/var/tmp/ocis/tmp/users").
-gateway-endpoint | $STORAGE_GATEWAY_ENDPOINT
endpoint to use for the storage gateway service. Default: flags.OverrideDefaultString(cfg.Reva.Gateway.Endpoint, "localhost:9142").
-users-endpoint | $STORAGE_USERPROVIDER_ENDPOINT
endpoint to use for the storage service. Default: flags.OverrideDefaultString(cfg.Reva.Users.Endpoint, "localhost:9144").

storage gateway

Start gateway

Usage: storage gateway [command options] [arguments...]

-debug-addr | $STORAGE_GATEWAY_DEBUG_ADDR
Address to bind debug server. Default: flags.OverrideDefaultString(cfg.Reva.Gateway.DebugAddr, "0.0.0.0:9143").
-transfer-secret | $STORAGE_TRANSFER_SECRET
Transfer secret for datagateway. Default: flags.OverrideDefaultString(cfg.Reva.TransferSecret, "replace-me-with-a-transfer-secret").
-network | $STORAGE_GATEWAY_GRPC_NETWORK
Network to use for the storage service, can be ‘tcp’, ‘udp’ or ‘unix’. Default: flags.OverrideDefaultString(cfg.Reva.Gateway.GRPCNetwork, "tcp").
-addr | $STORAGE_GATEWAY_GRPC_ADDR
Address to bind storage service. Default: flags.OverrideDefaultString(cfg.Reva.Gateway.GRPCAddr, "0.0.0.0:9142").
-endpoint | $STORAGE_GATEWAY_ENDPOINT
endpoint to use for the storage service. Default: flags.OverrideDefaultString(cfg.Reva.Gateway.Endpoint, "localhost:9142").
-commit-share-to-storage-grant | $STORAGE_GATEWAY_COMMIT_SHARE_TO_STORAGE_GRANT
Commit shares to the share manager. Default: flags.OverrideDefaultBool(cfg.Reva.Gateway.CommitShareToStorageGrant, true).
-commit-share-to-storage-ref | $STORAGE_GATEWAY_COMMIT_SHARE_TO_STORAGE_REF
Commit shares to the storage. Default: flags.OverrideDefaultBool(cfg.Reva.Gateway.CommitShareToStorageRef, true).
-share-folder | $STORAGE_GATEWAY_SHARE_FOLDER
mount shares in this folder of the home storage provider. Default: flags.OverrideDefaultString(cfg.Reva.Gateway.ShareFolder, "Shares").
-disable-home-creation-on-login | $STORAGE_GATEWAY_DISABLE_HOME_CREATION_ON_LOGIN
Disable creation of home folder on login.
-storage-home-mapping | $STORAGE_GATEWAY_HOME_MAPPING
mapping template for user home paths to user-specific mount points, e.g. /home/{{substr 0 1 .Username}}. Default: flags.OverrideDefaultString(cfg.Reva.Gateway.HomeMapping, "").
-auth-basic-endpoint | $STORAGE_AUTH_BASIC_ENDPOINT
endpoint to use for the basic auth provider. Default: flags.OverrideDefaultString(cfg.Reva.AuthBasic.Endpoint, "localhost:9146").
-auth-bearer-endpoint | $STORAGE_AUTH_BEARER_ENDPOINT
endpoint to use for the bearer auth provider. Default: flags.OverrideDefaultString(cfg.Reva.AuthBearer.Endpoint, "localhost:9148").
-storage-registry-driver | $STORAGE_STORAGE_REGISTRY_DRIVER
driver of the storage registry. Default: flags.OverrideDefaultString(cfg.Reva.StorageRegistry.Driver, "static").
-storage-home-provider | $STORAGE_STORAGE_REGISTRY_HOME_PROVIDER
mount point of the storage provider for user homes in the global namespace. Default: flags.OverrideDefaultString(cfg.Reva.StorageRegistry.HomeProvider, "/home").
-storage-registry-json | $STORAGE_STORAGE_REGISTRY_JSON
JSON file containing the storage registry rules. Default: flags.OverrideDefaultString(cfg.Reva.StorageRegistry.JSON, "").
-public-url | $STORAGE_FRONTEND_PUBLIC_URL , $OCIS_URL
URL to use for the storage service. Default: flags.OverrideDefaultString(cfg.Reva.Frontend.PublicURL, "https://localhost:9200").
-datagateway-url | $STORAGE_DATAGATEWAY_PUBLIC_URL
URL to use for the storage datagateway, defaults to <STORAGE_FRONTEND_PUBLIC_URL>/data. Default: flags.OverrideDefaultString(cfg.Reva.DataGateway.PublicURL, "").
-userprovider-endpoint | $STORAGE_USERPROVIDER_ENDPOINT
endpoint to use for the userprovider. Default: flags.OverrideDefaultString(cfg.Reva.Users.Endpoint, "localhost:9144").
-groupprovider-endpoint | $STORAGE_GROUPPROVIDER_ENDPOINT
endpoint to use for the groupprovider. Default: flags.OverrideDefaultString(cfg.Reva.Groups.Endpoint, "localhost:9160").
-sharing-endpoint | $STORAGE_SHARING_ENDPOINT
endpoint to use for the storage service. Default: flags.OverrideDefaultString(cfg.Reva.Sharing.Endpoint, "localhost:9150").
-storage-home-endpoint | $STORAGE_HOME_ENDPOINT
endpoint to use for the home storage. Default: flags.OverrideDefaultString(cfg.Reva.StorageHome.Endpoint, "localhost:9154").
-storage-home-mount-path | $STORAGE_HOME_MOUNT_PATH
mount path. Default: flags.OverrideDefaultString(cfg.Reva.StorageHome.MountPath, "/home").
-storage-home-mount-id | $STORAGE_HOME_MOUNT_ID
mount id. Default: flags.OverrideDefaultString(cfg.Reva.StorageHome.MountID, "1284d238-aa92-42ce-bdc4-0b0000009154").
-storage-users-endpoint | $STORAGE_USERS_ENDPOINT
endpoint to use for the users storage. Default: flags.OverrideDefaultString(cfg.Reva.StorageUsers.Endpoint, "localhost:9157").
-storage-users-mount-path | $STORAGE_USERS_MOUNT_PATH
mount path. Default: flags.OverrideDefaultString(cfg.Reva.StorageUsers.MountPath, "/users").
-storage-users-mount-id | $STORAGE_USERS_MOUNT_ID
mount id. Default: flags.OverrideDefaultString(cfg.Reva.StorageUsers.MountID, "1284d238-aa92-42ce-bdc4-0b0000009157").
-public-link-endpoint | $STORAGE_PUBLIC_LINK_ENDPOINT
endpoint to use for the public links service. Default: flags.OverrideDefaultString(cfg.Reva.StoragePublicLink.Endpoint, "localhost:9178").
-storage-public-link-mount-path | $STORAGE_PUBLIC_LINK_MOUNT_PATH
mount path. Default: flags.OverrideDefaultString(cfg.Reva.StoragePublicLink.MountPath, "/public").

storage storage

Storage service for oCIS

Usage: storage storage [command options] [arguments...]

-config-file | $STORAGE_CONFIG_FILE
Path to config file.
-log-level | $STORAGE_LOG_LEVEL , $OCIS_LOG_LEVEL
Set logging level.
-log-pretty | $STORAGE_LOG_PRETTY , $OCIS_LOG_PRETTY
Enable pretty logging.
-log-color | $STORAGE_LOG_COLOR , $OCIS_LOG_COLOR
Enable colored logging.

storage groups

Start groups service

Usage: storage groups [command options] [arguments...]

-debug-addr | $STORAGE_GROUPPROVIDER_DEBUG_ADDR
Address to bind debug server. Default: flags.OverrideDefaultString(cfg.Reva.Groups.DebugAddr, "0.0.0.0:9161").
-network | $STORAGE_GROUPPROVIDER_NETWORK
Network to use for the storage service, can be ‘tcp’, ‘udp’ or ‘unix’. Default: flags.OverrideDefaultString(cfg.Reva.Groups.GRPCNetwork, "tcp").
-addr | $STORAGE_GROUPPROVIDER_ADDR
Address to bind storage service. Default: flags.OverrideDefaultString(cfg.Reva.Groups.GRPCAddr, "0.0.0.0:9160").
-endpoint | $STORAGE_GROUPPROVIDER_ENDPOINT
URL to use for the storage service. Default: flags.OverrideDefaultString(cfg.Reva.Groups.Endpoint, "localhost:9160").
-driver | $STORAGE_GROUPPROVIDER_DRIVER
group driver: ‘json’, ‘ldap’, or ‘rest’. Default: flags.OverrideDefaultString(cfg.Reva.Groups.Driver, "ldap").
-json-config | $STORAGE_GROUPPROVIDER_JSON
Path to groups.json file. Default: flags.OverrideDefaultString(cfg.Reva.Groups.JSON, "").

storage health

Check health status

Usage: storage health [command options] [arguments...]

-debug-addr | $STORAGE_DEBUG_ADDR
Address to debug endpoint. Default: flags.OverrideDefaultString(cfg.Debug.Addr, "0.0.0.0:9109").

storage sharing

Start sharing service

Usage: storage sharing [command options] [arguments...]

-debug-addr | $STORAGE_SHARING_DEBUG_ADDR
Address to bind debug server. Default: flags.OverrideDefaultString(cfg.Reva.Sharing.DebugAddr, "0.0.0.0:9151").
-network | $STORAGE_SHARING_GRPC_NETWORK
Network to use for the storage service, can be ‘tcp’, ‘udp’ or ‘unix’. Default: flags.OverrideDefaultString(cfg.Reva.Sharing.GRPCNetwork, "tcp").
-addr | $STORAGE_SHARING_GRPC_ADDR
Address to bind storage service. Default: flags.OverrideDefaultString(cfg.Reva.Sharing.GRPCAddr, "0.0.0.0:9150").
-user-driver | $STORAGE_SHARING_USER_DRIVER
driver to use for the UserShareProvider. Default: flags.OverrideDefaultString(cfg.Reva.Sharing.UserDriver, "json").
-user-json-file | $STORAGE_SHARING_USER_JSON_FILE
file used to persist shares for the UserShareProvider. Default: flags.OverrideDefaultString(cfg.Reva.Sharing.UserJSONFile, "/var/tmp/ocis/storage/shares.json").
-public-driver | $STORAGE_SHARING_PUBLIC_DRIVER
driver to use for the PublicShareProvider. Default: flags.OverrideDefaultString(cfg.Reva.Sharing.PublicDriver, "json").
-public-json-file | $STORAGE_SHARING_PUBLIC_JSON_FILE
file used to persist shares for the PublicShareProvider. Default: flags.OverrideDefaultString(cfg.Reva.Sharing.PublicJSONFile, "/var/tmp/ocis/storage/publicshares.json").
-public-enable-expired-shares-cleanup | $STORAGE_SHARING_PUBLIC_ENABLE_EXPIRED_SHARES_CLEANUP
whether to periodically delete expired public shares. Default: flags.OverrideDefaultBool(cfg.Reva.Sharing.PublicEnableExpiredSharesCleanup, true).

storage storage-metadata

Start storage-metadata service

Usage: storage storage-metadata [command options] [arguments...]

Config for the different Storage Drivers

You can set different storage drivers for the Storage Providers. Please check the storage provider configuration.

Example: Set the home and users Storage Provider to ocis

STORAGE_HOME_DRIVER=ocis STORAGE_USERS_DRIVER=ocis

Local Driver

-storage-local-root | $STORAGE_DRIVER_LOCAL_ROOT
the path to the local storage root. Default: flags.OverrideDefaultString(cfg.Reva.Storages.Local.Root, "/var/tmp/ocis/storage/local").

Eos Driver

-storage-eos-namespace | $STORAGE_DRIVER_EOS_NAMESPACE
Namespace for metadata operations. Default: flags.OverrideDefaultString(cfg.Reva.Storages.EOS.Root, "/eos/dockertest/reva").
-storage-eos-shadow-namespace | $STORAGE_DRIVER_EOS_SHADOW_NAMESPACE
Shadow namespace where share references are stored.
-storage-eos-share-folder | $STORAGE_DRIVER_EOS_SHARE_FOLDER
name of the share folder. Default: flags.OverrideDefaultString(cfg.Reva.Storages.EOS.ShareFolder, "/Shares").
-storage-eos-binary | $STORAGE_DRIVER_EOS_BINARY
Location of the eos binary. Default: flags.OverrideDefaultString(cfg.Reva.Storages.EOS.EosBinary, "/usr/bin/eos").
-storage-eos-xrdcopy-binary | $STORAGE_DRIVER_EOS_XRDCOPY_BINARY
Location of the xrdcopy binary. Default: flags.OverrideDefaultString(cfg.Reva.Storages.EOS.XrdcopyBinary, "/usr/bin/xrdcopy").
-storage-eos-master-url | $STORAGE_DRIVER_EOS_MASTER_URL
URL of the Master EOS MGM. Default: flags.OverrideDefaultString(cfg.Reva.Storages.EOS.MasterURL, "root://eos-mgm1.eoscluster.cern.ch:1094").
-storage-eos-slave-url | $STORAGE_DRIVER_EOS_SLAVE_URL
URL of the Slave EOS MGM. Default: flags.OverrideDefaultString(cfg.Reva.Storages.EOS.SlaveURL, "root://eos-mgm1.eoscluster.cern.ch:1094").
-storage-eos-cache-directory | $STORAGE_DRIVER_EOS_CACHE_DIRECTORY
Location on the local fs where to store reads. Default: flags.OverrideDefaultString(cfg.Reva.Storages.EOS.CacheDirectory, os.TempDir()).
-storage-eos-enable-logging | $STORAGE_DRIVER_EOS_ENABLE_LOGGING
Enables logging of the commands executed.
-storage-eos-show-hidden-sysfiles | $STORAGE_DRIVER_EOS_SHOW_HIDDEN_SYSFILES
show internal EOS files like .sys.v# and .sys.a# files..
-storage-eos-force-singleuser-mode | $STORAGE_DRIVER_EOS_FORCE_SINGLEUSER_MODE
force connections to EOS to use SingleUsername.
-storage-eos-use-keytab | $STORAGE_DRIVER_EOS_USE_KEYTAB
authenticate requests by using an EOS keytab.
-storage-eos-enable-home | $STORAGE_DRIVER_EOS_ENABLE_HOME
enable the creation of home directories.
-storage-eos-sec-protocol | $STORAGE_DRIVER_EOS_SEC_PROTOCOL
the xrootd security protocol to use between the server and EOS.
-storage-eos-keytab | $STORAGE_DRIVER_EOS_KEYTAB
the location of the keytab to use to authenticate to EOS.
-storage-eos-single-username | $STORAGE_DRIVER_EOS_SINGLE_USERNAME
the username to use when SingleUserMode is enabled.
-storage-eos-layout | $STORAGE_DRIVER_EOS_LAYOUT
"layout of the users home dir path on disk, in addition to {{.Username}}, {{.UsernameLower}} and {{.Provider}} also supports prefixing dirs: "{{.UsernamePrefixCount.2}}/{{.UsernameLower}}" will turn "Einstein" into "Ei/Einstein" . Default: flags.OverrideDefaultString(cfg.Reva.Storages.EOS.UserLayout, "{{substr 0 1 .Username}}/{{.Username}}").
-storage-eos-gatewaysvc | $STORAGE_DRIVER_EOS_GATEWAYSVC
URL to use for the storage gateway service. Default: flags.OverrideDefaultString(cfg.Reva.Storages.EOS.GatewaySVC, "localhost:9142").

owCloud Driver

-storage-owncloud-datadir | $STORAGE_DRIVER_OWNCLOUD_DATADIR
the path to the owncloud data directory. Default: flags.OverrideDefaultString(cfg.Reva.Storages.OwnCloud.Root, "/var/tmp/ocis/storage/owncloud").
-storage-owncloud-uploadinfo-dir | $STORAGE_DRIVER_OWNCLOUD_UPLOADINFO_DIR
the path to the tus upload info directory. Default: flags.OverrideDefaultString(cfg.Reva.Storages.OwnCloud.UploadInfoDir, "/var/tmp/ocis/storage/uploadinfo").
-storage-owncloud-share-folder | $STORAGE_DRIVER_OWNCLOUD_SHARE_FOLDER
name of the shares folder. Default: flags.OverrideDefaultString(cfg.Reva.Storages.OwnCloud.ShareFolder, "/Shares").
-storage-owncloud-scan | $STORAGE_DRIVER_OWNCLOUD_SCAN
scan files on startup to add fileids. Default: flags.OverrideDefaultBool(cfg.Reva.Storages.OwnCloud.Scan, true).
-storage-owncloud-redis | $STORAGE_DRIVER_OWNCLOUD_REDIS_ADDR
the address of the redis server. Default: flags.OverrideDefaultString(cfg.Reva.Storages.OwnCloud.Redis, ":6379").
-storage-owncloud-enable-home | $STORAGE_DRIVER_OWNCLOUD_ENABLE_HOME
enable the creation of home storages. Default: flags.OverrideDefaultBool(cfg.Reva.Storages.OwnCloud.EnableHome, false).
-storage-owncloud-layout | $STORAGE_DRIVER_OWNCLOUD_LAYOUT
"layout of the users home dir path on disk, in addition to {{.Username}}, {{.Mail}}, {{.Id.OpaqueId}}, {{.Id.Idp}} also supports prefixing dirs: "{{substr 0 1 .Username}}/{{.Username}}" will turn "Einstein" into "Ei/Einstein" . Default: flags.OverrideDefaultString(cfg.Reva.Storages.OwnCloud.UserLayout, "{{.Id.OpaqueId}}").

Ocis Driver

-storage-ocis-root | $STORAGE_DRIVER_OCIS_ROOT
the path to the local storage root. Default: flags.OverrideDefaultString(cfg.Reva.Storages.Common.Root, "/var/tmp/ocis/storage/users").
-storage-ocis-enable-home | $STORAGE_DRIVER_OCIS_ENABLE_HOME
enable the creation of home storages. Default: flags.OverrideDefaultBool(cfg.Reva.Storages.Common.EnableHome, false).
-storage-ocis-layout | $STORAGE_DRIVER_OCIS_LAYOUT
"layout of the users home dir path on disk, in addition to {{.Username}}, {{.Mail}}, {{.Id.OpaqueId}}, {{.Id.Idp}} also supports prefixing dirs: "{{substr 0 1 .Username}}/{{.Username}}" will turn "Einstein" into "Ei/Einstein" . Default: flags.OverrideDefaultString(cfg.Reva.Storages.Common.UserLayout, "{{.Id.OpaqueId}}").
-service-user-uuid | $STORAGE_DRIVER_OCIS_SERVICE_USER_UUID
uuid of the internal service user. Default: 95cb8724-03b2-11eb-a0a6-c33ef8ef53ad.

S3ng Driver

-storage-s3ng-root | $STORAGE_DRIVER_S3NG_ROOT
the path to the local storage root. Default: flags.OverrideDefaultString(cfg.Reva.Storages.Common.Root, "/var/tmp/ocis/storage/users").
-storage-s3ng-enable-home | $STORAGE_DRIVER_S3NG_ENABLE_HOME
enable the creation of home storages. Default: flags.OverrideDefaultBool(cfg.Reva.Storages.Common.EnableHome, false).
-storage-s3ng-layout | $STORAGE_DRIVER_S3NG_LAYOUT
"layout of the users home dir path on disk, in addition to {{.Username}}, {{.Mail}}, {{.Id.OpaqueId}}, {{.Id.Idp}} also supports prefixing dirs: "{{substr 0 1 .Username}}/{{.Username}}" will turn "Einstein" into "Ei/Einstein" . Default: flags.OverrideDefaultString(cfg.Reva.Storages.Common.UserLayout, "{{.Id.OpaqueId}}").
-storage-s3ng-region | $STORAGE_DRIVER_S3NG_REGION
"the s3 region" . Default: default.
-storage-s3ng-accesskey | $STORAGE_DRIVER_S3NG_ACCESS_KEY
"the s3 access key" .
-storage-s3ng-secretkey | $STORAGE_DRIVER_S3NG_SECRET_KEY
"the secret s3 api key" .
-storage-s3ng-endpoint | $STORAGE_DRIVER_S3NG_ENDPOINT
"s3 compatible API endpoint" .
-storage-s3ng-bucket | $STORAGE_DRIVER_S3NG_BUCKET
"bucket where the data will be stored in.