Media Section

The Media section allows you to customise where media uploaded to your homeserver should be stored and the maximum upload size. By default this is to a Persistent Volume Claim (PVC) however you can also configure options for using S3.

All settings configured via the UI in this section will be saved to your deployment.yml, with the contents of secrets being saved to secrets.yml. You will find specific configuration examples in each section.

Config Example

deployment.yml

metadata:
  annotations:
    ui.element.io/layer: |
      components:
        synapse:
          config:
            media:
spec:
  components:
    synapse:
      config:
        media:

secrets.yml

kind: Secret
metadata:
  name: synapse
  namespace: element-onprem
data:

By default, if you do not change any settings on this page, defaults will be added to your configuration file/s (see example below).

Config Example

deployment.yml

spec:
  components:
    synapse:
      config:
        media:
          maxUploadSize: 100M
          volume:
            size: 50Gi

Config

Media

Config Example

spec:
  components:
    synapse:
      config:
        media:
          volume: # (1)!
            size: 50Gi

Present if you select either Persistent Volume Claim option

Selecting either Persistent Volume Claim configuration option will default to using a 50Gi volume for media.

S3

Config Example

spec:
  components:
    synapse:
      config:
        media:
          s3:
            bucket: example_bucket_name
            prefix: example_prefix
            storageClass: STANDARD # (1)!

Not present if left as default

Provide your bucket name and a prefix within the bucket to use. You can also adjust the storage class however it is recommended to leave it as STANDARD unless you have a specific requirement to change.

Authentication

Config Example

secrets.yml

apiVersion: v1
kind: Secret
metadata:
  name: synapse
  namespace: element-onprem
data:
  mediaS3StorageAccessKeyId: ZXhhbXBsZWFjY2Vzc2tleWlk
  mediaS3StorageSecretKey: ZXhhbXBsZXNlY3JldGFjY2Vzc2tleQ==

Provide any credentials (Access Key ID and Secret Access Key) required to authenticate access to the specified S3 bucket.

Region

Config Example

spec:
  components:
    synapse:
      config:
        media:
          s3:
            region: eu-central-1 # (1)!

Not present if disabled

Toggle on this section to be able to specify the S3 bucket region you wish to use.

Endpoint URL

Config Example

spec:
  components:
    synapse:
      config:
        media:
          s3:
            endpointUrl: https://example-endpoint.url # (1)!

Not present if disabled

Toggle on this section to be able to specify a non-AWS S3 endpoint URL.

Local Clean Up

Config Example

spec:
  components:
    synapse:
      config:
        media:
          s3:
            localCleanup: # (1)!
              frequency: 2h # (2)!
              threshold: 2d # (2)!

Not present if disabled, If defaults left as-is:
```
localCleanup: {}
```
Only present if changed from default

Toggle on this section to control the frequency of local storage clean up and the threshold since media was last accessed before it should be offloaded to S3.

Max Upload Size

Config Example

spec:
  components:
    synapse:
      config:
        media:
          maxUploadSize: 100M

By default the Max Upload size is 100M, here you can adjust this value to allow for larger or smaller uploads on your homeserver. The desired file size should be specified in bytes ending with M or K.