Setting up a dedicated document storage

A relational database isn’t an ideal location to store large binary files. For files like documents that participants upload to a conversation, you should instead use a blob store such as Amazon S3 (or a compatible service like min.io), Azure Blob Storage, or Google Cloud Storage.

Amazon AWS S3 or min.io configuration

Listing 1. Unblu configuration to use min.io or AWS S3

com.unblu.server.storage.blob.persistentStoreType=S3
com.unblu.server.storage.blob.store.s3.bucketName=local-dev
com.unblu.server.storage.blob.store.s3.endpoint=http\://minio.example.com\:9001 (1)
com.unblu.server.storage.blob.store.s3.folder=blobs
com.unblu.management.aws.accessKey=<key> (2)
com.unblu.management.aws.secretKey=<secret> (3)

1	Remove this line to use AWS S3 instead of min.io.
2	Add your access key here.
3	Add your access secret here.

Azure Blob Storage configuration

Listing 2. Unblu configuration to use Azure Blob Storage

com.unblu.server.storage.blob.store.azure.authenticationType=connection_string (1)
com.unblu.server.storage.blob.store.azure.loadDataFromDatabaseIfAvailable=true
com.unblu.server.storage.blob.store.azure.streamWriteSize=40960
<a href="../../../reference/configuration-properties.html#com-unblu-server-storage-blob-store-azure-createcontainerifnotexists">com.unblu.server.storage.blob.store.azure.createContainerIfNotExists</a>
config:com.unblu.server.storage.blob.store.azure.

1	To use Azure authentication with a server principal, set to `spn`.

Depending on the authentication type you chose, you must provided different additional information:

To use a connection string to access the blob store, set the following configuration property:
Listing 3. Configuration for Azure authorization with a connection string
```
com.unblu.server.storage.blob.store.azure.storageConnectionString=<connection-string> (1)
```
1 Add your connection string here.

To use Azure Active Directory (AAD) OAuth 2.0 authentication for the blob store, you must set the following configuration properties:

Listing 4. Configuration for AAD OAuth 2.0 authentication

com.unblu.server.storage.blob.store.azure.clientId=<clientId>
com.unblu.server.storage.blob.store.azure.clientSecret=<client-secret>
com.unblu.server.storage.blob.store.azure.environment=AZURE (1)
com.unblu.server.storage.blob.store.azure.spnAuthenticationThreadPoolSize=1 (2)
com.unblu.server.storage.blob.store.azure.storageAccountName=<account-name>
com.unblu.server.storage.blob.store.azure.storageEndpoint=<endpoint>
com.unblu.server.storage.blob.store.azure.tenantId=<tenantId>

1	Replace with the appropriate value for your use case.
2	Replace with the appropriate value for your use case.

Replace the placeholders above with the appropriate values. For more information, refer to the Azure documentation.

Google Cloud Storage configuration

Listing 5. Unblu configuration to use Google Cloud Storage (GCS)

com.unblu.server.storage.blob.persistentStoreType=GCS
com.unblu.server.storage.blob.store.gcs.bucketName=local-dev
com.unblu.server.storage.blob.store.gcs.folder=blobs
com.unblu.server.storage.blob.store.gcs.gcsServiceAccountKey[PROPERTIES, <key>] (1)

1	Add your service account key in JSON format here. If omitted, Application Default Credentials (ADC) are used.