finallycoffee/matrix-docker-ansible-deploy
finallycoffee/matrix-docker-ansible-deploy
5
1
Fork 0
Code Issues Pull Requests Releases Wiki Activity

Updated matrix media repo to v1.3.3

Browse Source
This commit is contained in:
Michael Hollister 2023-12-04 12:37:39 -06:00
parent 8060ca9199
commit 305e3afb1b
3 changed files with 728 additions and 698 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

709
roles/custom/matrix-media-repo/defaults/main.yml
View File

@ -19,7 +19,7 @@ matrix_media_repo_docker_image_path: "turt2live/matrix-media-repo"
matrix_media_repo_docker_image: "{{ matrix_media_repo_docker_image_name_prefix }}{{ matrix_media_repo_docker_image_path }}:{{ matrix_media_repo_docker_image_tag }}" matrix_media_repo_docker_image: "{{ matrix_media_repo_docker_image_name_prefix }}{{ matrix_media_repo_docker_image_path }}:{{ matrix_media_repo_docker_image_tag }}"
matrix_media_repo_docker_image_name_prefix: "{{ 'localhost/' if matrix_media_repo_container_image_self_build else matrix_container_global_registry_prefix }}" matrix_media_repo_docker_image_name_prefix: "{{ 'localhost/' if matrix_media_repo_container_image_self_build else matrix_container_global_registry_prefix }}"
# renovate: datasource=docker depName=turt2live/matrix-media-repo # renovate: datasource=docker depName=turt2live/matrix-media-repo
matrix_media_repo_docker_image_tag: "v1.2.13" matrix_media_repo_docker_image_tag: "v1.3.3"
matrix_media_repo_docker_image_force_pull: "{{ matrix_media_repo_docker_image.endswith(':latest') }}" matrix_media_repo_docker_image_force_pull: "{{ matrix_media_repo_docker_image.endswith(':latest') }}"
matrix_media_repo_base_path: "{{ matrix_base_data_path }}/{{ matrix_media_repo_identifier }}" matrix_media_repo_base_path: "{{ matrix_base_data_path }}/{{ matrix_media_repo_identifier }}"
@ -105,6 +105,21 @@ matrix_media_repo_use_forwarded_host: true
# the remote server do not count towards this. # the remote server do not count towards this.
matrix_media_repo_federation_backoff_at: 20 matrix_media_repo_federation_backoff_at: 20
# The domains the media repo should never serve media for. Existing media already stored from
# these domains will remain, however will not be downloadable without a data export. Media
# repo administrators will bypass this check. Admin APIs will still work for media on these
# domains.
#
# This will not prevent the listed domains from accessing media on this media repo - it only
# stops users on *this* media repo from accessing media originally uploaded to the listed domains.
#
# Note: Adding domains controlled by the media repo itself to this list is not advisable.
# matrix_media_repo_federation_ignored_hosts: [
# "example.org"
# ]
matrix_media_repo_federation_ignored_hosts: []
# The database configuration for the media repository # The database configuration for the media repository
# Do NOT put your homeserver's existing database credentials here. Create a new database and # Do NOT put your homeserver's existing database credentials here. Create a new database and
# user instead. Using the same server is fine, just not the same username and database. # user instead. Using the same server is fine, just not the same username and database.
@ -130,25 +145,31 @@ matrix_media_repo_database_max_idle_connections: 5
# The configuration for the homeservers this media repository is known to control. Servers # The configuration for the homeservers this media repository is known to control. Servers
# not listed here will not be able to upload media. # not listed here will not be able to upload media.
matrix_media_repo_homeservers: matrix_media_repo_homeservers: "{{ matrix_media_repo_homeservers_auto + matrix_media_repo_homeservers_additional }}"
homeservers:
# Auto configured server setup by the playbook
matrix_media_repo_homeservers_auto:
- # Keep the dash from this line.
# This should match the server_name of your homeserver, and the Host header # This should match the server_name of your homeserver, and the Host header
# provided to the media repo. # provided to the media repo.
- name: "{{ matrix_server_fqn_matrix }}" name: "{{ matrix_server_fqn_matrix }}"
# The base URL to where the homeserver can actually be reached # The base URL to where the homeserver can actually be reached by MMR.
csApi: "http://{{ matrix_nginx_proxy_proxy_matrix_client_api_addr_with_container }}" csApi: "http://{{ matrix_nginx_proxy_proxy_matrix_client_api_addr_with_container }}"
# The number of consecutive failures in calling this homeserver before the # The number of consecutive failures in calling this homeserver before the
# media repository will start backing off. This defaults to 10 if not given. # media repository will start backing off. This defaults to 10 if not given.
backoffAt: 10 backoffAt: 10
# The kind of admin API the homeserver supports. If set to "matrix", # The admin API interface supported by the homeserver. MMR uses a subset of the admin API
# the media repo will use the Synapse-defined endpoints under the # during certain operations, like attempting to purge media from a room or validating server
# unstable client-server API. When this is "synapse", the new /_synapse # admin status. This should be set to one of "synapse", "dendrite", or "matrix". When set
# endpoints will be used instead. Unknown values are treated as the # to "matrix", most functionality requiring the admin API will not work.
# default, "matrix". adminApiKind: "{{ 'synapse' if matrix_homeserver_implementation == 'synapse' else 'matrix' }}"
adminApiKind: "{{ 'synapse' if matrix_homeserver_implementation == 'synapse' else 'matrix' }}"
# Additional servers to be managed by MMR
matrix_media_repo_homeservers_additional: []
# Options for controlling how access tokens work with the media repo. It is recommended that if # Options for controlling how access tokens work with the media repo. It is recommended that if
# you are going to use these options that the `/logout` and `/logout/all` client-server endpoints # you are going to use these options that the `/logout` and `/logout/all` client-server endpoints
@ -166,45 +187,51 @@ matrix_media_repo_homeservers:
# *************************************************************************** # ***************************************************************************
# * IT IS HIGHLY RECOMMENDED TO USE PER-DOMAIN CONFIGS WITH THIS FEATURE. * # * IT IS HIGHLY RECOMMENDED TO USE PER-DOMAIN CONFIGS WITH THIS FEATURE. *
# *************************************************************************** # ***************************************************************************
matrix_media_repo_access_tokens:
accessTokens:
# The maximum time a cached access token will be considered valid. Set to zero (the default)
# to disable the cache and constantly hit the homeserver. This is recommended to be set to
# 43200 (12 hours) on servers with the logout endpoints proxied through the media repo, and
# zero for servers who do not proxy the endpoints through.
maxCacheTimeSeconds: 43200
# Whether or not to use the `appservices` config option below. If disabled (the default), # The maximum time a cached access token will be considered valid. Set to zero (the default)
# the regular access token cache will be used for each user, potentially leading to high # to disable the cache and constantly hit the homeserver. This is recommended to be set to
# memory usage. # 43200 (12 hours) on servers with the logout endpoints proxied through the media repo, and
useLocalAppserviceConfig: false # zero for servers who do not proxy the endpoints through.
matrix_media_repo_access_tokens_max_cache_time_seconds: 43200
# The application services (and their namespaces) registered on the homeserver. Only used # Whether or not to use the `appservices` config option below. If disabled (the default),
# if `useLocalAppserviceConfig` is enabled (recommended). # the regular access token cache will be used for each user, potentially leading to high
# # memory usage.
# Usually the appservice will provide you with these config details - they'll just need matrix_media_repo_access_tokens_use_local_appservice_config: false
# translating from the appservice registration to here. Note that this does not require
# all options from the registration, and only requires the bare minimum required to run # The application services (and their namespaces) registered on the homeserver. Only used
# the media repo. # if `useLocalAppserviceConfig` is enabled (recommended).
# appservices: #
# - id: Name_of_appservice_for_your_reference # Usually the appservice will provide you with these config details - they'll just need
# asToken: Secret_token_for_appservices_to_use # translating from the appservice registration to here. Note that this does not require
# senderUserId: "@_example_bridge:yourdomain.com" # all options from the registration, and only requires the bare minimum required to run
# userNamespaces: # the media repo.
# - regex: "@_example_bridge_.+:yourdomain.com" # matrix_media_repo_access_tokens_appservices: [
# # A note about regexes: it is best to suffix *all* namespaces with the homeserver # {
# # domain users are valid for, as otherwise the appservice can use any user with # id: "Name_of_appservice_for_your_reference",
# # any domain name it feels like, even if that domain is not configured with the # asToken: "Secret_token_for_appservices_to_use",
# # media repo. This will lead to inaccurate reporting in the case of the media # senderUserId: "@_example_bridge:yourdomain.com",
# # repo, and potentially leading to media being considered "remote". # userNamespaces: [
# regex: "@_example_bridge_.+:yourdomain.com"
# # A note about regexes: it is best to suffix *all* namespaces with the homeserver
# # domain users are valid for, as otherwise the appservice can use any user with
# # any domain name it feels like, even if that domain is not configured with the
# # media repo. This will lead to inaccurate reporting in the case of the media
# # repo, and potentially leading to media being considered "remote".
# ]
# }
# ]
matrix_media_repo_access_tokens_appservices: []
# These users have full access to the administrative functions of the media repository. # These users have full access to the administrative functions of the media repository.
# See docs/admin.md for information on what these people can do. They must belong to one of the # See docs/admin.md for information on what these people can do. They must belong to one of the
# configured homeservers above. # configured homeservers above.
matrix_media_repo_admins: # matrix_media_repo_admins: [
admins: [] # "@your_username:example.org"
# admins: # ]
# - "@your_username:example.org"
matrix_media_repo_admins: []
# Shared secret auth is useful for applications building on top of the media repository, such # Shared secret auth is useful for applications building on top of the media repository, such
# as a management interface. The `token` provided here is treated as a repository administrator # as a management interface. The `token` provided here is treated as a repository administrator
@ -220,58 +247,62 @@ matrix_media_repo_shared_secret_auth_token: "PutSomeRandomSecureValueHere"
# Datastores are places where media should be persisted. This isn't dedicated for just uploads: # Datastores are places where media should be persisted. This isn't dedicated for just uploads:
# thumbnails and other misc data is also stored in these places. The media repo, when looking # thumbnails and other misc data is also stored in these places. The media repo, when looking
# for a datastore to use, will always use the smallest datastore first. # for a datastore to use, will always use the smallest datastore first.
matrix_media_repo_datastores:
datastores:
- type: file
enabled: true # Enable this to set up data storage.
# Datastores can be split into many areas when handling uploads. Media is still de-duplicated
# across all datastores (local content which duplicates remote content will re-use the remote
# content's location). This option is useful if your datastore is becoming very large, or if
# you want faster storage for a particular kind of media.
#
# The kinds available are:
# thumbnails - Used to store thumbnails of media (local and remote).
# remote_media - Original copies of remote media (servers not configured by this repo).
# local_media - Original uploads for local media.
# archives - Archives of content (GDPR and similar requests).
forKinds: ["thumbnails", "remote_media", "local_media", "archives"]
opts:
path: /data/media
- type: s3 # ID for the file datastore (cannot change). Alphanumeric recommended.
enabled: false # Enable this to set up s3 uploads matrix_media_repo_datastore_file_id: "{{ '%s' | format(matrix_homeserver_generic_secret_key) | password_hash('sha512', 'filestore.db', rounds=655555) | to_uuid }}"
forKinds: ["thumbnails", "remote_media", "local_media", "archives"]
opts:
# The s3 uploader needs a temporary location to buffer files to reduce memory usage on
# small file uploads. If the file size is unknown, the file is written to this location
# before being uploaded to s3 (then the file is deleted). If you aren't concerned about
# memory usage, set this to an empty string.
tempPath: "/tmp/mediarepo_s3_upload"
endpoint: sfo2.digitaloceanspaces.com
accessKeyId: ""
accessSecret: ""
ssl: true
bucketName: "your-media-bucket"
# An optional region for where this S3 endpoint is located. Typically not needed, though
# some providers will need this (like Scaleway). Uncomment to use.
# region: "sfo2"
# An optional storage class for tuning how the media is stored at s3.
# See https://aws.amazon.com/s3/storage-classes/ for details; uncomment to use.
# storageClass: STANDARD
# The media repo does support an IPFS datastore, but only if the IPFS feature is enabled. If # Datastores can be split into many areas when handling uploads. Media is still de-duplicated
# the feature is not enabled, this will not work. Note that IPFS support is experimental at # across all datastores (local content which duplicates remote content will re-use the remote
# the moment and not recommended for general use. # content's location). This option is useful if your datastore is becoming very large, or if
# # you want faster storage for a particular kind of media.
# NOTE: Everything you upload to IPFS will be publicly accessible, even when the media repo #
# puts authentication on the download endpoints. Only use this option for cases where you # To disable this datastore, making it readonly, specify `forKinds: []`.
# expect your media to be publicly accessible. #
- type: ipfs # The kinds available are:
enabled: false # Enable this to use IPFS support # thumbnails - Used to store thumbnails of media (local and remote).
forKinds: ["local_media"] # remote_media - Original copies of remote media (servers not configured by this repo).
# The IPFS datastore currently has no options. It will use the daemon or HTTP API configured # local_media - Original uploads for local media.
# in the IPFS section of your main config. # archives - Archives of content (GDPR and similar requests).
opts: {} matrix_media_repo_datastore_file_for_kinds: ["thumbnails", "remote_media", "local_media", "archives"]
# Path to datastore, relative to matrix-media-repo directory root
matrix_media_repo_datastore_opts_path: "/data/media"
# ID for the s3 datastore (cannot change). Alphanumeric recommended.
matrix_media_repo_datastore_s3_id: "{{ '%s' | format(matrix_homeserver_generic_secret_key) | password_hash('sha512', 's3store.db', rounds=655555) | to_uuid }}"
# Datastores can be split into many areas when handling uploads. Media is still de-duplicated
# across all datastores (local content which duplicates remote content will re-use the remote
# content's location). This option is useful if your datastore is becoming very large, or if
# you want faster storage for a particular kind of media.
#
# To disable this datastore, making it readonly, specify `forKinds: []`.
#
# The kinds available are:
# thumbnails - Used to store thumbnails of media (local and remote).
# remote_media - Original copies of remote media (servers not configured by this repo).
# local_media - Original uploads for local media.
# archives - Archives of content (GDPR and similar requests).
matrix_media_repo_datastore_s3_for_kinds: []
# The s3 uploader needs a temporary location to buffer files to reduce memory usage on
# small file uploads. If the file size is unknown, the file is written to this location
# before being uploaded to s3 (then the file is deleted). If you aren't concerned about
# memory usage, set this to an empty string.
matrix_media_repo_datastore_s3_opts_temp_path: "/tmp/mediarepo_s3_upload"
matrix_media_repo_datastore_s3_opts_endpoint: "sfo2.digitaloceanspaces.com"
matrix_media_repo_datastore_s3_opts_access_key_id: ""
matrix_media_repo_datastore_s3_opts_access_secret: ""
matrix_media_repo_datastore_s3_opts_ssl: true
matrix_media_repo_datastore_s3_opts_bucket_name: "your-media-bucket"
# An optional region for where this S3 endpoint is located. Typically not needed, though
# some providers will need this (like Scaleway). Uncomment to use.
# matrix_media_repo_datastore_s3_opts_region: "sfo2"
# An optional storage class for tuning how the media is stored at s3.
# See https://aws.amazon.com/s3/storage-classes/ for details; uncomment to use.
# matrix_media_repo_datastore_s3_opts_storage_class: "STANDARD"
# Options for controlling archives. Archives are exports of a particular user's content for # Options for controlling archives. Archives are exports of a particular user's content for
# the purpose of GDPR or moving media to a different server. # the purpose of GDPR or moving media to a different server.
@ -291,42 +322,65 @@ matrix_media_repo_archiving_self_service: false
matrix_media_repo_archiving_target_bytes_per_part: 209715200 # 200mb default matrix_media_repo_archiving_target_bytes_per_part: 209715200 # 200mb default
# The file upload settings for the media repository # The file upload settings for the media repository
matrix_media_repo_uploads:
uploads:
# The maximum individual file size a user can upload.
maxBytes: 104857600 # 100MB default, 0 to disable
# The minimum number of bytes to let people upload. This is recommended to be non-zero to # The maximum individual file size a user can upload.
# ensure that the "cost" of running the media repo is worthwhile - small file uploads tend matrix_media_repo_max_bytes: 104857600 # 100MB default, 0 to disable
# to waste more CPU and database resources than small files, thus a default of 100 bytes
# is applied here as an approximate break-even point.
minBytes: 100 # 100 bytes by default
# The number of bytes to claim as the maximum size for uploads for the limits API. If this # The minimum number of bytes to let people upload. This is recommended to be non-zero to
# is not provided then the maxBytes setting will be used instead. This is useful to provide # ensure that the "cost" of running the media repo is worthwhile - small file uploads tend
# if the media repo's settings and the reverse proxy do not match for maximum request size. # to waste more CPU and database resources than small files, thus a default of 100 bytes
# This is purely for informational reasons and does not actually limit any functionality. # is applied here as an approximate break-even point.
# Set this to -1 to indicate that there is no limit. Zero will force the use of maxBytes. matrix_media_repo_min_bytes: 100 # 100 bytes by default
reportedMaxBytes: 0
# Options for limiting how much content a user can upload. Quotas are applied to content # The number of bytes to claim as the maximum size for uploads for the limits API. If this
# associated with a user regardless of de-duplication. Quotas which affect remote servers # is not provided then the maxBytes setting will be used instead. This is useful to provide
# or users will not take effect. When a user exceeds their quota they will be unable to # if the media repo's settings and the reverse proxy do not match for maximum request size.
# upload any more media. # This is purely for informational reasons and does not actually limit any functionality.
quotas: # Set this to -1 to indicate that there is no limit. Zero will force the use of maxBytes.
# Whether or not quotas are enabled/enforced. Note that even when disabled the media repo matrix_media_repo_reported_max_bytes: 0
# will track how much media a user has uploaded. This is disabled by default.
enabled: false
# The quota rules that affect users. The first rule to match the uploader will take effect. # The number of pending uploads a user is permitted to have at a given time. They must cancel,
# An implied rule which matches all users and has no quota is always last in this list, # complete, or otherwise let pending requests expire before uploading any more media. Set to
# meaning that if no rules are supplied then users will be able to upload anything. Similarly, # zero to disable.
# if no rules match a user then the implied rule will match, allowing the user to have no matrix_media_repo_max_pending: 5
# quota. The quota will let the user upload to 1 media past their quota, meaning that from
# a statistics perspective the user might exceed their quota however only by a small amount. # The duration the server will wait to receive media that was asynchronously uploaded before
users: # expiring it entirely. This should be set sufficiently high for a client on poor connectivity
- glob: "@*:*" # Affect all users. Use asterisks (*) to match any character. # to upload something. The Matrix specification recommends 24 hours (86400 seconds), however
maxBytes: 53687063712 # 50GB default, 0 to disable # this project recommends 30 minutes (1800 seconds).
matrix_media_repo_max_age_seconds: 1800
# Options for limiting how much content a user can upload. Quotas are applied to content
# associated with a user regardless of de-duplication. Quotas which affect remote servers
# or users will not take effect. When a user exceeds their quota they will be unable to
# upload any more media.
# Whether quotas are enabled/enforced. Note that even when disabled the media repo will
# track how much media a user has uploaded. Quotas are disabled by default.
matrix_media_repo_quotas_enabled: false
# The upload quota rules which affect users. The first rule to match the user ID will take
# effect. If a user does not match a rule, the defaults implied by the above config will
# take effect instead. The user will not be permitted to upload anything above these quota
# values, but can match them exactly.
matrix_media_repo_quotas_users: "{{ matrix_media_repo_quotas_users_auto + matrix_media_repo_quotas_users_additional }}"
matrix_media_repo_quotas_users_auto:
- glob: "@*:*" # Affect all users. Use asterisks (*) to match any character.
# The maximum number of TOTAL bytes a user can upload. Defaults to zero (no limit).
maxBytes: 53687063712 # 50gb
# The same as maxPending above - the number of uploads the user can have waiting to
# complete before starting another one. Defaults to maxPending above. Set to 0 to
# disable.
maxPending: 5
# The maximum number of uploaded files a user can have. Defaults to zero (no limit).
# If both maxBytes and maxFiles are in use then the first condition a user triggers
# will prevent upload. Note that a user can still have uploads contributing to maxPending,
# but will not be able to complete them if they are at maxFiles.
maxFiles: 0
# Additional quota glob patterns
matrix_media_repo_quotas_users_additional: []
# Settings related to downloading files from the media repository # Settings related to downloading files from the media repository
@ -344,186 +398,175 @@ matrix_media_repo_downloads_num_workers: 10
# has passed, the media is able to be re-requested. # has passed, the media is able to be re-requested.
matrix_media_repo_downloads_failure_cache_minutes: 5 matrix_media_repo_downloads_failure_cache_minutes: 5
# The cache control settings for downloads. This can help speed up downloads for users by
# keeping popular media in the cache. This cache is also used for thumbnails.
matrix_media_repo_downloads_cache_enabled: true
# The maximum size of cache to have. Higher numbers are better.
matrix_media_repo_downloads_cache_max_size_bytes: 1048576000 # 1GB default
# The maximum file size to cache. This should normally be the same size as your maximum
# upload size.
matrix_media_repo_downloads_cache_max_file_size_bytes: 104857600 # 100MB default
# The number of minutes to track how many downloads a file gets
matrix_media_repo_downloads_cache_tracked_minutes: 30
# The number of downloads a file must receive in the window above (trackedMinutes) in
# order to be cached.
matrix_media_repo_downloads_cache_min_downloads: 5
# The minimum amount of time an item should remain in the cache. This prevents the cache
# from cycling out the file if it needs more room during this time. Note that the media
# repo regularly cleans out media which is past this point from the cache, so this number
# may need increasing depending on your use case. If the maxSizeBytes is reached for the
# media repo, and some cached items are still under this timer, new items will not be able
# to enter the cache. When this happens, consider raising maxSizeBytes or lowering this
# timer.
matrix_media_repo_downloads_cache_min_cache_time_seconds: 300
# The minimum amount of time an item should remain outside the cache once it is removed.
matrix_media_repo_downloads_cache_min_evicted_time_seconds: 60
# How many days after a piece of remote content is downloaded before it expires. It can be # How many days after a piece of remote content is downloaded before it expires. It can be
# re-downloaded on demand, this just helps free up space in your datastore. Set to zero or # re-downloaded on demand, this just helps free up space in your datastore. Set to zero or
# negative to disable. Defaults to disabled. # negative to disable. Defaults to disabled.
matrix_media_repo_downloads_expire_after_days: 0 matrix_media_repo_downloads_expire_after_days: 0
# The default size, in bytes, to return for range requests on media. Range requests are used
# by clients when they only need part of a file, such as a video or audio element. Note that
# the entire file will still be cached (if enabled), but only part of it will be returned.
# If the client requests a larger or smaller range, that will be honoured.
matrix_media_repo_downloads_default_range_chunk_size_bytes: 10485760 # 10MB default
# URL Preview settings # URL Preview settings
matrix_media_repo_url_previews:
urlPreviews:
enabled: true # If enabled, the preview_url routes will be accessible
maxPageSizeBytes: 10485760 # 10MB default, 0 to disable
# If true, the media repository will try to provide previews for URLs with invalid or unsafe # If enabled, the preview_url routes will be accessible
# certificates. If false (the default), the media repo will fail requests to said URLs. matrix_media_repo_url_previews_enabled: true
previewUnsafeCertificates: false
# Note: URL previews are limited to a given number of words, which are then limited to a number # 10MB default, 0 to disable
# of characters, taking off the last word if it needs to. This also applies for the title. matrix_media_repo_url_previews_max_page_size_bytes: 10485760
numWords: 50 # The number of words to include in a preview (maximum) # If true, the media repository will try to provide previews for URLs with invalid or unsafe
maxLength: 200 # The maximum number of characters for a description # certificates. If false (the default), the media repo will fail requests to said URLs.
matrix_media_repo_url_previews_preview_unsafe_certificates: false
numTitleWords: 30 # The maximum number of words to include in a preview's title # Note: URL previews are limited to a given number of words, which are then limited to a number
maxTitleLength: 150 # The maximum number of characters for a title # of characters, taking off the last word if it needs to. This also applies for the title.
# The mime types to preview when OpenGraph previews cannot be rendered. OpenGraph previews are # The number of words to include in a preview (maximum)
# calculated on anything matching "text/*". To have a thumbnail in the preview the URL must be matrix_media_repo_url_previews_num_words: 50
# an image and the image's type must be allowed by the thumbnailer.
filePreviewTypes:
- "image/*"
# The number of workers to use when generating url previews. Raise this number if url # The maximum number of characters for a description
# previews are slow or timing out. matrix_media_repo_url_previews_max_length: 200
#
# Maximum memory usage = numWorkers multiplied by the maximum page size
# Average memory usage is dependent on how many concurrent urls your users are previewing.
numWorkers: 10
# Either allowedNetworks or disallowedNetworks must be provided. If both are provided, they # The maximum number of words to include in a preview's title
# will be merged. URL previews will be disabled if neither is supplied. Each entry must be matrix_media_repo_url_previews_num_title_words: 30
# a CIDR range.
disallowedNetworks:
- "127.0.0.1/8"
- "10.0.0.0/8"
- "172.16.0.0/12"
- "192.168.0.0/16"
- "100.64.0.0/10"
- "169.254.0.0/16"
- '::1/128'
- 'fe80::/64'
- 'fc00::/7'
allowedNetworks:
# "Everything". The blacklist will help limit this.
# This is the default value for this field.
- "0.0.0.0/0"
# How many days after a preview is generated before it expires and is deleted. The preview # The maximum number of characters for a title
# can be regenerated safely - this just helps free up some space in your database. Set to matrix_media_repo_url_previews_max_title_length: 150
# zero or negative to disable. Defaults to disabled.
expireAfterDays: 0
# The default Accept-Language header to supply when generating URL previews when one isn't # The mime types to preview when OpenGraph previews cannot be rendered. OpenGraph previews are
# supplied by the client. # calculated on anything matching "text/*". To have a thumbnail in the preview the URL must be
# Reference: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language # an image and the image's type must be allowed by the thumbnailer.
defaultLanguage: "en-US,en" matrix_media_repo_url_previews_file_preview_types:
- "image/*"
# When true, oEmbed previews will be enabled. Typically these kinds of previews are used for # The number of workers to use when generating url previews. Raise this number if url
# sites that do not support OpenGraph or page scraping, such as Twitter. For information on # previews are slow or timing out.
# specifying providers for oEmbed, including your own, see the following documentation: #
# https://docs.t2bot.io/matrix-media-repo/url-previews/oembed.html # Maximum memory usage = numWorkers multiplied by the maximum page size
# Defaults to disabled. # Average memory usage is dependent on how many concurrent urls your users are previewing.
oEmbed: false matrix_media_repo_url_previews_num_workers: 10
# Either allowedNetworks or disallowedNetworks must be provided. If both are provided, they
# will be merged. URL previews will be disabled if neither is supplied. Each entry must be
# a CIDR range.
matrix_media_repo_url_previews_disallowed_networks:
- "127.0.0.1/8"
- "10.0.0.0/8"
- "172.16.0.0/12"
- "192.168.0.0/16"
- "100.64.0.0/10"
- "169.254.0.0/16"
- '::1/128'
- 'fe80::/64'
- 'fc00::/7'
matrix_media_repo_url_previews_allowed_networks:
# "Everything". The blacklist will help limit this.
# This is the default value for this field.
- "0.0.0.0/0"
# How many days after a preview is generated before it expires and is deleted. The preview
# can be regenerated safely - this just helps free up some space in your database. Set to
# zero or negative to disable. Defaults to disabled.
matrix_media_repo_url_previews_expire_after_days: 0
# The default Accept-Language header to supply when generating URL previews when one isn't
# supplied by the client.
# Reference: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language
matrix_media_repo_url_previews_default_language: "en-US,en"
# Set the User-Agent header to supply when generating URL previews
matrix_media_repo_url_previews_user_agent: "matrix-media-repo"
# When true, oEmbed previews will be enabled. Typically these kinds of previews are used for
# sites that do not support OpenGraph or page scraping, such as Twitter. For information on
# specifying providers for oEmbed, including your own, see the following documentation:
# https://docs.t2bot.io/matrix-media-repo/url-previews/oembed.html
# Defaults to disabled.
matrix_media_repo_url_previews_o_embed: false
# The thumbnail configuration for the media repository. # The thumbnail configuration for the media repository.
matrix_media_repo_thumbnails:
thumbnails:
# The maximum number of bytes an image can be before the thumbnailer refuses.
maxSourceBytes: 10485760 # 10MB default, 0 to disable
# The maximum number of pixels an image can have before the thumbnailer refuses. Note that # The maximum number of bytes an image can be before the thumbnailer refuses.
# this only applies to image types: file types like audio and video are affected solely by matrix_media_repo_thumbnails_max_source_bytes: 10485760 # 10MB default, 0 to disable
# the maxSourceBytes.
maxPixels: 32000000 # 32M default
# The number of workers to use when generating thumbnails. Raise this number if thumbnails # The maximum number of pixels an image can have before the thumbnailer refuses. Note that
# are slow to generate or timing out. # this only applies to image types: file types like audio and video are affected solely by
# # the maxSourceBytes.
# Maximum memory usage = numWorkers multiplied by the maximum image source size matrix_media_repo_thumbnails_max_pixels: 32000000 # 32M default
# Average memory usage is dependent on how many thumbnails are being generated by your users
numWorkers: 100
# All thumbnails are generated into one of the sizes listed here. The first size is used as # The number of workers to use when generating thumbnails. Raise this number if thumbnails
# the default for when no width or height is requested. The media repository will return # are slow to generate or timing out.
# either an exact match or the next largest size of thumbnail. #
sizes: # Maximum memory usage = numWorkers multiplied by the maximum image source size
- width: 32 # Average memory usage is dependent on how many thumbnails are being generated by your users
height: 32 matrix_media_repo_thumbnails_num_workers: 100
- width: 96
height: 96
- width: 320
height: 240
- width: 640
height: 480
- width: 768 # This size is primarily used for audio thumbnailing.
height: 240
- width: 800
height: 600
# To allow for thumbnails to be any size, not just in the sizes specified above, set this to # All thumbnails are generated into one of the sizes listed here. The first size is used as
# true (default false). When enabled, whatever size requested by the client will be generated # the default for when no width or height is requested. The media repository will return
# up to a maximum of the largest possible dimensions in the `sizes` list. For best results, # either an exact match or the next largest size of thumbnail.
# specify only one size in the `sizes` list when this option is enabled. matrix_media_repo_thumbnails_sizes:
dynamicSizing: false - width: 32
height: 32
- width: 96
height: 96
- width: 320
height: 240
- width: 640
height: 480
- width: 768 # This size is primarily used for audio thumbnailing.
height: 240
- width: 800
height: 600
# The content types to thumbnail when requested. Types that are not supported by the media repo # To allow for thumbnails to be any size, not just in the sizes specified above, set this to
# will not be thumbnailed (adding application/json here won't work). Clients may still not request # true (default false). When enabled, whatever size requested by the client will be generated
# thumbnails for these types - this won't make clients automatically thumbnail these file types. # up to a maximum of the largest possible dimensions in the `sizes` list. For best results,
types: # specify only one size in the `sizes` list when this option is enabled.
- "image/jpeg" matrix_media_repo_thumbnails_dynamic_sizing: false
- "image/jpg"
- "image/png"
- "image/apng"
- "image/gif"
- "image/heif"
- "image/webp"
# - "image/svg+xml" # Be sure to have ImageMagick installed to thumbnail SVG files
- "audio/mpeg"
- "audio/ogg"
- "audio/wav"
- "audio/flac"
# - "video/mp4" # Be sure to have ffmpeg installed to thumbnail video files
# Animated thumbnails can be CPU intensive to generate. To disable the generation of animated # The content types to thumbnail when requested. Types that are not supported by the media repo
# thumbnails, set this to false. If disabled, regular thumbnails will be returned. # will not be thumbnailed (adding application/json here won't work). Clients may still not request
allowAnimated: true # thumbnails for these types - this won't make clients automatically thumbnail these file types.
matrix_media_repo_thumbnails_types:
- "image/jpeg"
- "image/jpg"
- "image/png"
- "image/apng"
- "image/gif"
- "image/heif"
- "image/heic"
- "image/webp"
- "image/bmp"
- "image/tiff"
#- "image/svg+xml" # Be sure to have ImageMagick installed to thumbnail SVG files
- "audio/mpeg"
- "audio/ogg"
- "audio/wav"
- "audio/flac"
#- "video/mp4" # Be sure to have ffmpeg installed to thumbnail video files
# Default to animated thumbnails, if available # Animated thumbnails can be CPU intensive to generate. To disable the generation of animated
defaultAnimated: false # thumbnails, set this to false. If disabled, regular thumbnails will be returned.
matrix_media_repo_thumbnails_allow_animated: true
# The maximum file size to thumbnail when a capable animated thumbnail is requested. If the image # Default to animated thumbnails, if available
# is larger than this, the thumbnail will be generated as a static image. matrix_media_repo_thumbnails_default_animated: false
maxAnimateSizeBytes: 10485760 # 10MB default, 0 to disable
# On a scale of 0 (start of animation) to 1 (end of animation), where should the thumbnailer try # The maximum file size to thumbnail when a capable animated thumbnail is requested. If the image
# and thumbnail animated content? Defaults to 0.5 (middle of animation). # is larger than this, the thumbnail will be generated as a static image.
stillFrame: 0.5 matrix_media_repo_thumbnails_max_animate_size_bytes: 10485760 # 10MB default, 0 to disable
# How many days after a thumbnail is generated before it expires and is deleted. The thumbnail # On a scale of 0 (start of animation) to 1 (end of animation), where should the thumbnailer try
# can be regenerated safely - this just helps free up some space in your datastores. Set to # and thumbnail animated content? Defaults to 0.5 (middle of animation).
# zero or negative to disable. Defaults to disabled. matrix_media_repo_thumbnails_still_frame: 0.5
expireAfterDays: 0
# How many days after a thumbnail is generated before it expires and is deleted. The thumbnail
# can be regenerated safely - this just helps free up some space in your datastores. Set to
# zero or negative to disable. Defaults to disabled.
matrix_media_repo_thumbnails_expire_after_days: 0
# Controls for the rate limit functionality # Controls for the rate limit functionality
@ -623,67 +666,31 @@ matrix_media_repo_plugins:
# Options for controlling various MSCs/unstable features of the media repo # Options for controlling various MSCs/unstable features of the media repo
# Sections of this config might disappear or be added over time. By default all # Sections of this config might disappear or be added over time. By default all
# features are disabled in here and must be explicitly enabled to be used. # features are disabled in here and must be explicitly enabled to be used.
matrix_media_repo_feature_support: # featureSupport:
featureSupport: # No unstable features are currently supported.
# MSC2248 - Blurhash
MSC2448:
# Whether or not this MSC is enabled for use in the media repo
enabled: false
# Maximum dimensions for converting a blurhash to an image. When no width and # Support for redis as a cache mechanism
# height options are supplied, the default will be half these values. #
maxWidth: 1024 # Note: Enabling Redis support will mean that the existing cache mechanism will do nothing.
maxHeight: 1024 # It can be safely disabled once Redis support is enabled.
#
# See docs/redis.md for more information on how this works and how to set it up.
# Thumbnail size in pixels to use to generate the blurhash string # Whether or not use Redis instead of in-process caching.
thumbWidth: 64 matrix_media_repo_redis_enabled: false
thumbHeight: 64
# The X and Y components to use. Higher numbers blur less, lower numbers blur more. # The database number to use. Leave at zero if using a dedicated Redis instance.
xComponents: 4 matrix_media_repo_redis_database_number: 0
yComponents: 3
# The amount of contrast to apply when converting a blurhash to an image. Lower values # The Redis shards that should be used by the media repo in the ring. The names of the
# make the effect more subtle, larger values make it stronger. # shards are for your reference and have no bearing on the connection, but must be unique.
punch: 1 matrix_media_repo_redis_shards:
- name: "server1"
# IPFS Support addr: ":7000"
# This is currently experimental and might not work at all. - name: "server2"
IPFS: addr: ":7001"
# Whether or not IPFS support is enabled for use in the media repo. - name: "server3"
enabled: false addr: ":7002"
# Options for the built in IPFS daemon
builtInDaemon:
# Enable this to spawn an in-process IPFS node to use instead of a localhost
# HTTP agent. If this is disabled, the media repo will assume you have an HTTP
# IPFS agent running and accessible. Defaults to using a daemon (true).
enabled: true
# If the Daemon is enabled, set this to the location where the IPFS files should
# be stored. If you're using Docker, this should be something like "/data/ipfs"
# so it can be mapped to a volume.
repoPath: "./ipfs"
# Support for redis as a cache mechanism
#
# Note: Enabling Redis support will mean that the existing cache mechanism will do nothing.
# It can be safely disabled once Redis support is enabled.
#
# See docs/redis.md for more information on how this works and how to set it up.
redis:
# Whether or not use Redis instead of in-process caching.
enabled: false
# The Redis shards that should be used by the media repo in the ring. The names of the
# shards are for your reference and have no bearing on the connection, but must be unique.
shards:
- name: "server1"
addr: ":7000"
- name: "server2"
addr: ":7001"
- name: "server3"
addr: ":7002"
# Optional sentry (https://sentry.io/) configuration for the media repo # Optional sentry (https://sentry.io/) configuration for the media repo
@ -698,3 +705,27 @@ matrix_media_repo_sentry_environment: ""
# Whether or not to turn on sentry's built in debugging. This will increase log output. # Whether or not to turn on sentry's built in debugging. This will increase log output.
matrix_media_repo_sentry_debug: false matrix_media_repo_sentry_debug: false
# Configuration for the internal tasks engine in the media repo. Note that this only applies
# to the media repo process with machine ID zero (the default in single-instance mode).
#
# Tasks include things like data imports/exports.
# The number of workers to have available for tasks. Defaults to 5.
matrix_media_repo_tasks_num_workers: 5
# Options for collecting PGO-compatible CPU profiles and submitting them to a hosted pgo-fleet
# server. See https://github.com/t2bot/pgo-fleet for collection/more detail.
#
# If you process more than 1Hz of requests or have more than a dozen media repos deployed, please
# get in contact with `@travis:t2l.io` to submit profiles directly to MMR. Submitted profiles are
# used to improve the build speed for everyone.
# Whether collection is enabled. Defaults to false.
matrix_media_repo_pgo_enabled: false
# The pgo-fleet submit URL.
matrix_media_repo_pgo_submit_url: "https://pgo-mmr.t2host.io/v1/submit"
# The pgo-fleet submit key.
matrix_media_repo_pgo_submit_key: "INSERT_VALUE_HERE"

714
roles/custom/matrix-media-repo/templates/media-repo/media-repo.yaml.j2
View File

@ -41,6 +41,24 @@ federation:
# the remote server do not count towards this. # the remote server do not count towards this.
backoffAt: {{ matrix_media_repo_federation_backoff_at | to_json }} backoffAt: {{ matrix_media_repo_federation_backoff_at | to_json }}
# The domains the media repo should never serve media for. Existing media already stored from
# these domains will remain, however will not be downloadable without a data export. Media
# repo administrators will bypass this check. Admin APIs will still work for media on these
# domains.
#
# This will not prevent the listed domains from accessing media on this media repo - it only
# stops users on *this* media repo from accessing media originally uploaded to the listed domains.
#
# Note: Adding domains controlled by the media repo itself to this list is not advisable.
{% if (matrix_media_repo_federation_ignored_hosts | length) > 0 %}
ignoredHosts:
{{ matrix_media_repo_federation_ignored_hosts | to_json | from_json
| to_nice_yaml(indent=2, width=999999, sort_keys=false) | indent(width=4, first=true) }}
{% else %}
# ignoredHosts:
# - example.org
{% endif %}
# The database configuration for the media repository # The database configuration for the media repository
# Do NOT put your homeserver's existing database credentials here. Create a new database and # Do NOT put your homeserver's existing database credentials here. Create a new database and
# user instead. Using the same server is fine, just not the same username and database. # user instead. Using the same server is fine, just not the same username and database.
@ -61,17 +79,27 @@ database:
# The configuration for the homeservers this media repository is known to control. Servers # The configuration for the homeservers this media repository is known to control. Servers
# not listed here will not be able to upload media. # not listed here will not be able to upload media.
#homeservers: #homeservers:
# - name: example.org # This should match the server_name of your homeserver, and the Host header # - # Keep the dash from this line.
# # provided to the media repo. #
# csApi: "https://example.org/" # The base URL to where the homeserver can actually be reached # # This should match the server_name of your homeserver, and the Host header
# backoffAt: 10 # The number of consecutive failures in calling this homeserver before the # # provided to the media repo.
# # media repository will start backing off. This defaults to 10 if not given. # name: example.org
# adminApiKind: "matrix" # The kind of admin API the homeserver supports. If set to "matrix", #
# # the media repo will use the Synapse-defined endpoints under the # # The base URL to where the homeserver can actually be reached by MMR.
# # unstable client-server API. When this is "synapse", the new /_synapse # csApi: "https://example.org/"
# # endpoints will be used instead. Unknown values are treated as the #
# # default, "matrix". # # The number of consecutive failures in calling this homeserver before the
{{ matrix_media_repo_homeservers | to_json | from_json | to_nice_yaml(indent=2, width=999999, sort_keys=false) }} # # media repository will start backing off. This defaults to 10 if not given.
# backoffAt: 10
#
# # The admin API interface supported by the homeserver. MMR uses a subset of the admin API
# # during certain operations, like attempting to purge media from a room or validating server
# # admin status. This should be set to one of "synapse", "dendrite", or "matrix". When set
# # to "matrix", most functionality requiring the admin API will not work.
# adminApiKind: "synapse"
homeservers:
{{ matrix_media_repo_homeservers | to_json | from_json
| to_nice_yaml(indent=2, width=999999, sort_keys=false) | indent(width=2, first=true) }}
# Options for controlling how access tokens work with the media repo. It is recommended that if # Options for controlling how access tokens work with the media repo. It is recommended that if
# you are going to use these options that the `/logout` and `/logout/all` client-server endpoints # you are going to use these options that the `/logout` and `/logout/all` client-server endpoints
@ -89,42 +117,58 @@ database:
# *************************************************************************** # ***************************************************************************
# * IT IS HIGHLY RECOMMENDED TO USE PER-DOMAIN CONFIGS WITH THIS FEATURE. * # * IT IS HIGHLY RECOMMENDED TO USE PER-DOMAIN CONFIGS WITH THIS FEATURE. *
# *************************************************************************** # ***************************************************************************
# accessTokens: accessTokens:
# # The maximum time a cached access token will be considered valid. Set to zero (the default) # The maximum time a cached access token will be considered valid. Set to zero (the default)
# # to disable the cache and constantly hit the homeserver. This is recommended to be set to # to disable the cache and constantly hit the homeserver. This is recommended to be set to
# # 43200 (12 hours) on servers with the logout endpoints proxied through the media repo, and # 43200 (12 hours) on servers with the logout endpoints proxied through the media repo, and
# # zero for servers who do not proxy the endpoints through. # zero for servers who do not proxy the endpoints through.
# maxCacheTimeSeconds: 0 maxCacheTimeSeconds: {{ matrix_media_repo_access_tokens_max_cache_time_seconds | to_json }}
#
# # Whether or not to use the `appservices` config option below. If disabled (the default), # Whether or not to use the `appservices` config option below. If disabled (the default),
# # the regular access token cache will be used for each user, potentially leading to high # the regular access token cache will be used for each user, potentially leading to high
# # memory usage. # memory usage.
# useLocalAppserviceConfig: false useLocalAppserviceConfig: {{ matrix_media_repo_access_tokens_use_local_appservice_config | to_json }}
#
# # The application services (and their namespaces) registered on the homeserver. Only used # The application services (and their namespaces) registered on the homeserver. Only used
# # if `useLocalAppserviceConfig` is enabled (recommended). # if `useLocalAppserviceConfig` is enabled (recommended).
# # #
# # Usually the appservice will provide you with these config details - they'll just need # Usually the appservice will provide you with these config details - they'll just need
# # translating from the appservice registration to here. Note that this does not require # translating from the appservice registration to here. Note that this does not require
# # all options from the registration, and only requires the bare minimum required to run # all options from the registration, and only requires the bare minimum required to run
# # the media repo. # the media repo.
# appservices: {% if (matrix_media_repo_access_tokens_appservices | length) > 0 %}
# - id: Name_of_appservice_for_your_reference {# `to_nice_yaml` filter unfortunately does not correctly indent arrays. The `indent` filter
# asToken: Secret_token_for_appservices_to_use is a workaround fixes top-level arrays, but does not fix nested arrays. Hence the use of
# senderUserId: "@_example_bridge:yourdomain.com" the `replace` filter. #}
# userNamespaces: appservices:
# - regex: "@_example_bridge_.+:yourdomain.com" {{ matrix_media_repo_access_tokens_appservices | to_json | from_json
# # A note about regexes: it is best to suffix *all* namespaces with the homeserver | to_nice_yaml(indent=2, width=999999, sort_keys=false) | indent(width=4, first=true)
# # domain users are valid for, as otherwise the appservice can use any user with | replace(" - ", " - ") }}
# # any domain name it feels like, even if that domain is not configured with the {% else%}
# # media repo. This will lead to inaccurate reporting in the case of the media # appservices:
# # repo, and potentially leading to media being considered "remote". # - id: Name_of_appservice_for_your_reference
{{ matrix_media_repo_access_tokens | to_json | from_json | to_nice_yaml(indent=2, width=999999, sort_keys=false) }} # asToken: Secret_token_for_appservices_to_use
# senderUserId: "@_example_bridge:yourdomain.com"
# userNamespaces:
# - regex: "@_example_bridge_.+:yourdomain.com"
# # A note about regexes: it is best to suffix *all* namespaces with the homeserver
# # domain users are valid for, as otherwise the appservice can use any user with
# # any domain name it feels like, even if that domain is not configured with the
# # media repo. This will lead to inaccurate reporting in the case of the media
# # repo, and potentially leading to media being considered "remote".
{% endif %}
# These users have full access to the administrative functions of the media repository. # These users have full access to the administrative functions of the media repository.
# See docs/admin.md for information on what these people can do. They must belong to one of the # See docs/admin.md for information on what these people can do. They must belong to one of the
# configured homeservers above. # configured homeservers above.
{{ matrix_media_repo_admins | to_json | from_json | to_nice_yaml(indent=2, width=999999, sort_keys=false) }} {% if (matrix_media_repo_admins | length) > 0 %}
admins:
{{ matrix_media_repo_admins | to_json | from_json
| to_nice_yaml(indent=2, width=999999, sort_keys=false) | indent(width=2, first=true) }}
{% else %}
#admins:
# - "@your_username:example.org"
{% endif %}
# Shared secret auth is useful for applications building on top of the media repository, such # Shared secret auth is useful for applications building on top of the media repository, such
# as a management interface. The `token` provided here is treated as a repository administrator # as a management interface. The `token` provided here is treated as a repository administrator
@ -141,55 +185,58 @@ sharedSecretAuth:
# Datastores are places where media should be persisted. This isn't dedicated for just uploads: # Datastores are places where media should be persisted. This isn't dedicated for just uploads:
# thumbnails and other misc data is also stored in these places. The media repo, when looking # thumbnails and other misc data is also stored in these places. The media repo, when looking
# for a datastore to use, will always use the smallest datastore first. # for a datastore to use, will always use the smallest datastore first.
# datastores: datastores:
# - type: file {% if (matrix_media_repo_datastore_file_for_kinds | length) > 0 %}
# enabled: false # Enable this to set up data storage. - type: file
# # Datastores can be split into many areas when handling uploads. Media is still de-duplicated # ID for this datastore (cannot change). Alphanumeric recommended.
# # across all datastores (local content which duplicates remote content will re-use the remote id: {{ matrix_media_repo_datastore_file_id | to_json }}
# # content's location). This option is useful if your datastore is becoming very large, or if # Datastores can be split into many areas when handling uploads. Media is still de-duplicated
# # you want faster storage for a particular kind of media. # across all datastores (local content which duplicates remote content will re-use the remote
# # # content's location). This option is useful if your datastore is becoming very large, or if
# # The kinds available are: # you want faster storage for a particular kind of media.
# # thumbnails - Used to store thumbnails of media (local and remote). #
# # remote_media - Original copies of remote media (servers not configured by this repo). # To disable this datastore, making it readonly, specify `forKinds: []`.
# # local_media - Original uploads for local media. #
# # archives - Archives of content (GDPR and similar requests). # The kinds available are:
# forKinds: ["thumbnails"] # thumbnails - Used to store thumbnails of media (local and remote).
# opts: # remote_media - Original copies of remote media (servers not configured by this repo).
# path: /var/matrix/media # local_media - Original uploads for local media.
# # archives - Archives of content (GDPR and similar requests).
# - type: s3 forKinds: {{ matrix_media_repo_datastore_file_for_kinds | to_json }}
# enabled: false # Enable this to set up s3 uploads opts:
# forKinds: ["thumbnails", "remote_media", "local_media", "archives"] path: {{ matrix_media_repo_datastore_opts_path | to_json }}
# opts: {% endif %}
# # The s3 uploader needs a temporary location to buffer files to reduce memory usage on {% if (matrix_media_repo_datastore_s3_for_kinds | length) > 0 %}
# # small file uploads. If the file size is unknown, the file is written to this location - type: s3
# # before being uploaded to s3 (then the file is deleted). If you aren't concerned about # ID for this datastore (cannot change). Alphanumeric recommended.
# # memory usage, set this to an empty string. id: {{ matrix_media_repo_datastore_s3_id | to_json }}
# tempPath: "/tmp/mediarepo_s3_upload" forKinds: {{ matrix_media_repo_datastore_s3_for_kinds | to_json }}
# endpoint: sfo2.digitaloceanspaces.com opts:
# accessKeyId: "" # The s3 uploader needs a temporary location to buffer files to reduce memory usage on
# accessSecret: "" # small file uploads. If the file size is unknown, the file is written to this location
# ssl: true # before being uploaded to s3 (then the file is deleted). If you aren't concerned about
# bucketName: "your-media-bucket" # memory usage, set this to an empty string.
# # An optional region for where this S3 endpoint is located. Typically not needed, though tempPath: {{ matrix_media_repo_datastore_s3_opts_temp_path | to_json }}
# # some providers will need this (like Scaleway). Uncomment to use. endpoint: {{ matrix_media_repo_datastore_s3_opts_endpoint | to_json }}
# #region: "sfo2" accessKeyId: {{ matrix_media_repo_datastore_s3_opts_access_key_id | to_json }}
# accessSecret: {{ matrix_media_repo_datastore_s3_opts_access_secret | to_json }}
# # The media repo does support an IPFS datastore, but only if the IPFS feature is enabled. If ssl: {{ matrix_media_repo_datastore_s3_opts_ssl | to_json }}
# # the feature is not enabled, this will not work. Note that IPFS support is experimental at bucketName: {{ matrix_media_repo_datastore_s3_opts_bucket_name | to_json }}
# # the moment and not recommended for general use. {% if matrix_media_repo_datastore_s3_opts_region is defined %}
# # region: {{ matrix_media_repo_datastore_s3_opts_region | to_json }}
# # NOTE: Everything you upload to IPFS will be publicly accessible, even when the media repo {% else %}
# # puts authentication on the download endpoints. Only use this option for cases where you # An optional region for where this S3 endpoint is located. Typically not needed, though
# # expect your media to be publicly accessible. # some providers will need this (like Scaleway). Uncomment to use.
# - type: ipfs #region: "sfo2"
# enabled: false # Enable this to use IPFS support {% endif %}
# forKinds: ["local_media"] {% if matrix_media_repo_datastore_s3_opts_storage_class is defined %}
# # The IPFS datastore currently has no options. It will use the daemon or HTTP API configured storageClass: {{ matrix_media_repo_datastore_s3_opts_storage_class | to_json }}
# # in the IPFS section of your main config. {% else %}
# opts: {} # An optional storage class for tuning how the media is stored at s3.
{{ matrix_media_repo_datastores | to_json | from_json | to_nice_yaml(indent=2, width=999999, sort_keys=false) }} # See https://aws.amazon.com/s3/storage-classes/ for details; uncomment to use.
#storageClass: STANDARD
{% endif %}
{% endif %}
# Options for controlling archives. Archives are exports of a particular user's content for # Options for controlling archives. Archives are exports of a particular user's content for
# the purpose of GDPR or moving media to a different server. # the purpose of GDPR or moving media to a different server.
@ -209,42 +256,50 @@ archiving:
targetBytesPerPart: {{ matrix_media_repo_archiving_target_bytes_per_part | to_json }} # 200mb default targetBytesPerPart: {{ matrix_media_repo_archiving_target_bytes_per_part | to_json }} # 200mb default
# The file upload settings for the media repository # The file upload settings for the media repository
# uploads: uploads:
# # The maximum individual file size a user can upload. # The maximum individual file size a user can upload.
# maxBytes: 104857600 # 100MB default, 0 to disable maxBytes: {{ matrix_media_repo_max_bytes | to_json }} # 100MB default, 0 to disable
#
# # The minimum number of bytes to let people upload. This is recommended to be non-zero to # The minimum number of bytes to let people upload. This is recommended to be non-zero to
# # ensure that the "cost" of running the media repo is worthwhile - small file uploads tend # ensure that the "cost" of running the media repo is worthwhile - small file uploads tend
# # to waste more CPU and database resources than small files, thus a default of 100 bytes # to waste more CPU and database resources than small files, thus a default of 100 bytes
# # is applied here as an approximate break-even point. # is applied here as an approximate break-even point.
# minBytes: 100 # 100 bytes by default minBytes: {{ matrix_media_repo_min_bytes | to_json }} # 100 bytes by default
#
# # The number of bytes to claim as the maximum size for uploads for the limits API. If this # The number of bytes to claim as the maximum size for uploads for the limits API. If this
# # is not provided then the maxBytes setting will be used instead. This is useful to provide # is not provided then the maxBytes setting will be used instead. This is useful to provide
# # if the media repo's settings and the reverse proxy do not match for maximum request size. # if the media repo's settings and the reverse proxy do not match for maximum request size.
# # This is purely for informational reasons and does not actually limit any functionality. # This is purely for informational reasons and does not actually limit any functionality.
# # Set this to -1 to indicate that there is no limit. Zero will force the use of maxBytes. # Set this to -1 to indicate that there is no limit. Zero will force the use of maxBytes.
# #reportedMaxBytes: 104857600 reportedMaxBytes: {{ matrix_media_repo_reported_max_bytes | to_json }}
#
# # Options for limiting how much content a user can upload. Quotas are applied to content # The number of pending uploads a user is permitted to have at a given time. They must cancel,
# # associated with a user regardless of de-duplication. Quotas which affect remote servers # complete, or otherwise let pending requests expire before uploading any more media. Set to
# # or users will not take effect. When a user exceeds their quota they will be unable to # zero to disable.
# # upload any more media. maxPending: {{ matrix_media_repo_max_pending | to_json }}
# quotas:
# # Whether or not quotas are enabled/enforced. Note that even when disabled the media repo # The duration the server will wait to receive media that was asynchronously uploaded before
# # will track how much media a user has uploaded. This is disabled by default. # expiring it entirely. This should be set sufficiently high for a client on poor connectivity
# enabled: false # to upload something. The Matrix specification recommends 24 hours (86400 seconds), however
# # this project recommends 30 minutes (1800 seconds).
# # The quota rules that affect users. The first rule to match the uploader will take effect. maxAgeSeconds: {{ matrix_media_repo_max_age_seconds | to_json }}
# # An implied rule which matches all users and has no quota is always last in this list,
# # meaning that if no rules are supplied then users will be able to upload anything. Similarly, # Options for limiting how much content a user can upload. Quotas are applied to content
# # if no rules match a user then the implied rule will match, allowing the user to have no # associated with a user regardless of de-duplication. Quotas which affect remote servers
# # quota. The quota will let the user upload to 1 media past their quota, meaning that from # or users will not take effect. When a user exceeds their quota they will be unable to
# # a statistics perspective the user might exceed their quota however only by a small amount. # upload any more media.
# users: quotas:
# - glob: "@*:*" # Affect all users. Use asterisks (*) to match any character. # Whether quotas are enabled/enforced. Note that even when disabled the media repo will
# maxBytes: 53687063712 # 50GB default, 0 to disable # track how much media a user has uploaded. Quotas are disabled by default.
{{ matrix_media_repo_uploads | to_json | from_json | to_nice_yaml(indent=2, width=999999, sort_keys=false) }} enabled: {{ matrix_media_repo_quotas_enabled | to_json }}
# The upload quota rules which affect users. The first rule to match the user ID will take
# effect. If a user does not match a rule, the defaults implied by the above config will
# take effect instead. The user will not be permitted to upload anything above these quota
# values, but can match them exactly.
users:
{{ matrix_media_repo_quotas_users | to_json | from_json
| to_nice_yaml(indent=2, width=999999, sort_keys=false) | indent(width=6, first=true) }}
# Settings related to downloading files from the media repository # Settings related to downloading files from the media repository
downloads: downloads:
@ -262,186 +317,143 @@ downloads:
# has passed, the media is able to be re-requested. # has passed, the media is able to be re-requested.
failureCacheMinutes: {{ matrix_media_repo_downloads_failure_cache_minutes | to_json }} failureCacheMinutes: {{ matrix_media_repo_downloads_failure_cache_minutes | to_json }}
# The cache control settings for downloads. This can help speed up downloads for users by
# keeping popular media in the cache. This cache is also used for thumbnails.
cache:
enabled: {{ matrix_media_repo_downloads_cache_enabled | to_json }}
# The maximum size of cache to have. Higher numbers are better.
maxSizeBytes: {{ matrix_media_repo_downloads_cache_max_size_bytes | to_json }} # 1GB default
# The maximum file size to cache. This should normally be the same size as your maximum
# upload size.
maxFileSizeBytes: {{ matrix_media_repo_downloads_cache_max_file_size_bytes | to_json }} # 100MB default
# The number of minutes to track how many downloads a file gets
trackedMinutes: {{ matrix_media_repo_downloads_cache_tracked_minutes | to_json }}
# The number of downloads a file must receive in the window above (trackedMinutes) in
# order to be cached.
minDownloads: {{ matrix_media_repo_downloads_cache_min_downloads | to_json }}
# The minimum amount of time an item should remain in the cache. This prevents the cache
# from cycling out the file if it needs more room during this time. Note that the media
# repo regularly cleans out media which is past this point from the cache, so this number
# may need increasing depending on your use case. If the maxSizeBytes is reached for the
# media repo, and some cached items are still under this timer, new items will not be able
# to enter the cache. When this happens, consider raising maxSizeBytes or lowering this
# timer.
minCacheTimeSeconds: {{ matrix_media_repo_downloads_cache_min_cache_time_seconds | to_json }}
# The minimum amount of time an item should remain outside the cache once it is removed.
minEvictedTimeSeconds: {{ matrix_media_repo_downloads_cache_min_evicted_time_seconds | to_json }}
# How many days after a piece of remote content is downloaded before it expires. It can be # How many days after a piece of remote content is downloaded before it expires. It can be
# re-downloaded on demand, this just helps free up space in your datastore. Set to zero or # re-downloaded on demand, this just helps free up space in your datastore. Set to zero or
# negative to disable. Defaults to disabled. # negative to disable. Defaults to disabled.
expireAfterDays: {{ matrix_media_repo_downloads_expire_after_days | to_json }} expireAfterDays: {{ matrix_media_repo_downloads_expire_after_days | to_json }}
# The default size, in bytes, to return for range requests on media. Range requests are used
# by clients when they only need part of a file, such as a video or audio element. Note that
# the entire file will still be cached (if enabled), but only part of it will be returned.
# If the client requests a larger or smaller range, that will be honoured.
defaultRangeChunkSizeBytes: {{ matrix_media_repo_downloads_default_range_chunk_size_bytes | to_json }} # 10MB default
# URL Preview settings # URL Preview settings
# urlPreviews: urlPreviews:
# enabled: true # If enabled, the preview_url routes will be accessible # If enabled, the preview_url routes will be accessible
# maxPageSizeBytes: 10485760 # 10MB default, 0 to disable enabled: {{ matrix_media_repo_url_previews_enabled | to_json }}
# # 10MB default, 0 to disable
# # If true, the media repository will try to provide previews for URLs with invalid or unsafe maxPageSizeBytes: {{ matrix_media_repo_url_previews_max_page_size_bytes | to_json }}
# # certificates. If false (the default), the media repo will fail requests to said URLs.
# previewUnsafeCertificates: false # If true, the media repository will try to provide previews for URLs with invalid or unsafe
# # certificates. If false (the default), the media repo will fail requests to said URLs.
# # Note: URL previews are limited to a given number of words, which are then limited to a number previewUnsafeCertificates: {{ matrix_media_repo_url_previews_preview_unsafe_certificates | to_json }}
# # of characters, taking off the last word if it needs to. This also applies for the title.
# # Note: URL previews are limited to a given number of words, which are then limited to a number
# numWords: 50 # The number of words to include in a preview (maximum) # of characters, taking off the last word if it needs to. This also applies for the title.
# maxLength: 200 # The maximum number of characters for a description
# # The number of words to include in a preview (maximum)
# numTitleWords: 30 # The maximum number of words to include in a preview's title numWords: {{ matrix_media_repo_url_previews_num_words | to_json }}
# maxTitleLength: 150 # The maximum number of characters for a title # The maximum number of characters for a description
# maxLength: {{ matrix_media_repo_url_previews_max_length | to_json }}
# # The mime types to preview when OpenGraph previews cannot be rendered. OpenGraph previews are
# # calculated on anything matching "text/*". To have a thumbnail in the preview the URL must be # The maximum number of words to include in a preview's title
# # an image and the image's type must be allowed by the thumbnailer. numTitleWords: {{ matrix_media_repo_url_previews_num_title_words | to_json }}
# filePreviewTypes: # The maximum number of characters for a title
# - "image/*" maxTitleLength: {{ matrix_media_repo_url_previews_max_title_length | to_json }}
#
# # The number of workers to use when generating url previews. Raise this number if url # The mime types to preview when OpenGraph previews cannot be rendered. OpenGraph previews are
# # previews are slow or timing out. # calculated on anything matching "text/*". To have a thumbnail in the preview the URL must be
# # # an image and the image's type must be allowed by the thumbnailer.
# # Maximum memory usage = numWorkers multiplied by the maximum page size filePreviewTypes:
# # Average memory usage is dependent on how many concurrent urls your users are previewing. {{ matrix_media_repo_url_previews_file_preview_types | to_json | from_json
# numWorkers: 10 | to_nice_yaml(indent=2, width=999999, sort_keys=false) | indent(width=4, first=true) }}
#
# # Either allowedNetworks or disallowedNetworks must be provided. If both are provided, they # The number of workers to use when generating url previews. Raise this number if url
# # will be merged. URL previews will be disabled if neither is supplied. Each entry must be # previews are slow or timing out.
# # a CIDR range. #
# disallowedNetworks: # Maximum memory usage = numWorkers multiplied by the maximum page size
# - "127.0.0.1/8" # Average memory usage is dependent on how many concurrent urls your users are previewing.
# - "10.0.0.0/8" numWorkers: {{ matrix_media_repo_url_previews_num_workers | to_json }}
# - "172.16.0.0/12"
# - "192.168.0.0/16" # Either allowedNetworks or disallowedNetworks must be provided. If both are provided, they
# - "100.64.0.0/10" # will be merged. URL previews will be disabled if neither is supplied. Each entry must be
# - "169.254.0.0/16" # a CIDR range.
# - '::1/128' disallowedNetworks:
# - 'fe80::/64' {{ matrix_media_repo_url_previews_disallowed_networks | to_json | from_json
# - 'fc00::/7' | to_nice_yaml(indent=2, width=999999, sort_keys=false) | indent(width=4, first=true) }}
# allowedNetworks: allowedNetworks:
# - "0.0.0.0/0" # "Everything". The blacklist will help limit this. # "Everything". The deny list will help limit this.
# # This is the default value for this field. # This is the default value for this field.
# {{ matrix_media_repo_url_previews_allowed_networks | to_json | from_json
# # How many days after a preview is generated before it expires and is deleted. The preview | to_nice_yaml(indent=2, width=999999, sort_keys=false) | indent(width=4, first=true) }}
# # can be regenerated safely - this just helps free up some space in your database. Set to
# # zero or negative to disable. Defaults to disabled. # How many days after a preview is generated before it expires and is deleted. The preview
# expireAfterDays: 0 # can be regenerated safely - this just helps free up some space in your database. Set to
# # zero or negative to disable. Defaults to disabled.
# # The default Accept-Language header to supply when generating URL previews when one isn't expireAfterDays: {{ matrix_media_repo_url_previews_expire_after_days | to_json }}
# # supplied by the client.
# # Reference: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language # The default Accept-Language header to supply when generating URL previews when one isn't
# defaultLanguage: "en-US,en" # supplied by the client.
# # Reference: https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Accept-Language
# # When true, oEmbed previews will be enabled. Typically these kinds of previews are used for defaultLanguage: {{ matrix_media_repo_url_previews_default_language | to_json }}
# # sites that do not support OpenGraph or page scraping, such as Twitter. For information on
# # specifying providers for oEmbed, including your own, see the following documentation: # Set the User-Agent header to supply when generating URL previews
# # https://docs.t2bot.io/matrix-media-repo/url-previews/oembed.html userAgent: {{ matrix_media_repo_url_previews_user_agent | to_json }}
# # Defaults to disabled.
# oEmbed: false # When true, oEmbed previews will be enabled. Typically, these kinds of previews are used for
{{ matrix_media_repo_url_previews | to_json | from_json | to_nice_yaml(indent=2, width=999999, sort_keys=false)}} # sites that do not support OpenGraph or page scraping, such as Twitter. For information on
# specifying providers for oEmbed, including your own, see the following documentation:
# https://docs.t2bot.io/matrix-media-repo/url-previews/oembed.html
# Defaults to disabled.
oEmbed: {{ matrix_media_repo_url_previews_o_embed | to_json }}
# The thumbnail configuration for the media repository. # The thumbnail configuration for the media repository.
# thumbnails: thumbnails:
# # The maximum number of bytes an image can be before the thumbnailer refuses. # The maximum number of bytes an image can be before the thumbnailer refuses.
# maxSourceBytes: 10485760 # 10MB default, 0 to disable maxSourceBytes: {{ matrix_media_repo_thumbnails_max_source_bytes | to_json }} # 10MB default, 0 to disable
#
# # The maximum number of pixels an image can have before the thumbnailer refuses. Note that # The maximum number of pixels an image can have before the thumbnailer refuses. Note that
# # this only applies to image types: file types like audio and video are affected solely by # this only applies to image types: file types like audio and video are affected solely by
# # the maxSourceBytes. # the maxSourceBytes.
# maxPixels: 32000000 # 32M default maxPixels: {{ matrix_media_repo_thumbnails_max_pixels | to_json }} # 32M default
#
# # The number of workers to use when generating thumbnails. Raise this number if thumbnails # The number of workers to use when generating thumbnails. Raise this number if thumbnails
# # are slow to generate or timing out. # are slow to generate or timing out.
# # #
# # Maximum memory usage = numWorkers multiplied by the maximum image source size # Maximum memory usage = numWorkers multiplied by the maximum image source size
# # Average memory usage is dependent on how many thumbnails are being generated by your users # Average memory usage is dependent on how many thumbnails are being generated by your users
# numWorkers: 100 numWorkers: {{ matrix_media_repo_thumbnails_num_workers | to_json }}
#
# # All thumbnails are generated into one of the sizes listed here. The first size is used as # All thumbnails are generated into one of the sizes listed here. The first size is used as
# # the default for when no width or height is requested. The media repository will return # the default for when no width or height is requested. The media repository will return
# # either an exact match or the next largest size of thumbnail. # either an exact match or the next largest size of thumbnail.
# sizes: sizes:
# - width: 32 {{ matrix_media_repo_thumbnails_sizes | to_json | from_json
# height: 32 | to_nice_yaml(indent=2, width=999999, sort_keys=false) | indent(width=4, first=true) }}
# - width: 96
# height: 96 # To allow for thumbnails to be any size, not just in the sizes specified above, set this to
# - width: 320 # true (default false). When enabled, whatever size requested by the client will be generated
# height: 240 # up to a maximum of the largest possible dimensions in the `sizes` list. For best results,
# - width: 640 # specify only one size in the `sizes` list when this option is enabled.
# height: 480 dynamicSizing: {{ matrix_media_repo_thumbnails_dynamic_sizing | to_json }}
# - width: 768 # This size is primarily used for audio thumbnailing.
# height: 240 # The content types to thumbnail when requested. Types that are not supported by the media repo
# - width: 800 # will not be thumbnailed (adding application/json here won't work). Clients may still not request
# height: 600 # thumbnails for these types - this won't make clients automatically thumbnail these file types.
# types:
# # To allow for thumbnails to be any size, not just in the sizes specified above, set this to {{ matrix_media_repo_thumbnails_types | to_json | from_json
# # true (default false). When enabled, whatever size requested by the client will be generated | to_nice_yaml(indent=2, width=999999, sort_keys=false) | indent(width=4, first=true) }}
# # up to a maximum of the largest possible dimensions in the `sizes` list. For best results,
# # specify only one size in the `sizes` list when this option is enabled. # Animated thumbnails can be CPU intensive to generate. To disable the generation of animated
# dynamicSizing: false # thumbnails, set this to false. If disabled, regular thumbnails will be returned.
# allowAnimated: {{ matrix_media_repo_thumbnails_allow_animated | to_json }}
# # The content types to thumbnail when requested. Types that are not supported by the media repo
# # will not be thumbnailed (adding application/json here won't work). Clients may still not request # Default to animated thumbnails, if available
# # thumbnails for these types - this won't make clients automatically thumbnail these file types. defaultAnimated: {{ matrix_media_repo_thumbnails_default_animated | to_json }}
# types:
# - "image/jpeg" # The maximum file size to thumbnail when a capable animated thumbnail is requested. If the image
# - "image/jpg" # is larger than this, the thumbnail will be generated as a static image.
# - "image/png" maxAnimateSizeBytes: {{ matrix_media_repo_thumbnails_max_animate_size_bytes | to_json }} # 10MB default, 0 to disable
# - "image/apng"
# - "image/gif" # On a scale of 0 (start of animation) to 1 (end of animation), where should the thumbnailer try
# - "image/heif" # and thumbnail animated content? Defaults to 0.5 (middle of animation).
# - "image/webp" stillFrame: {{ matrix_media_repo_thumbnails_still_frame | to_json }}
# #- "image/svg+xml" # Be sure to have ImageMagick installed to thumbnail SVG files
# - "audio/mpeg" # How many days after a thumbnail is generated before it expires and is deleted. The thumbnail
# - "audio/ogg" # can be regenerated safely - this just helps free up some space in your datastores. Set to
# - "audio/wav" # zero or negative to disable. Defaults to disabled.
# - "audio/flac" expireAfterDays: {{ matrix_media_repo_thumbnails_expire_after_days | to_json }}
# #- "video/mp4" # Be sure to have ffmpeg installed to thumbnail video files
#
# # Animated thumbnails can be CPU intensive to generate. To disable the generation of animated
# # thumbnails, set this to false. If disabled, regular thumbnails will be returned.
# allowAnimated: true
#
# # Default to animated thumbnails, if available
# defaultAnimated: false
#
# # The maximum file size to thumbnail when a capable animated thumbnail is requested. If the image
# # is larger than this, the thumbnail will be generated as a static image.
# maxAnimateSizeBytes: 10485760 # 10MB default, 0 to disable
#
# # On a scale of 0 (start of animation) to 1 (end of animation), where should the thumbnailer try
# # and thumbnail animated content? Defaults to 0.5 (middle of animation).
# stillFrame: 0.5
#
# # How many days after a thumbnail is generated before it expires and is deleted. The thumbnail
# # can be regenerated safely - this just helps free up some space in your datastores. Set to
# # zero or negative to disable. Defaults to disabled.
# expireAfterDays: 0
{{ matrix_media_repo_thumbnails | to_json | from_json | to_nice_yaml(indent=2, width=999999, sort_keys=false) }}
# Controls for the rate limit functionality # Controls for the rate limit functionality
rateLimit: rateLimit:
@ -543,66 +555,26 @@ metrics:
# Sections of this config might disappear or be added over time. By default all # Sections of this config might disappear or be added over time. By default all
# features are disabled in here and must be explicitly enabled to be used. # features are disabled in here and must be explicitly enabled to be used.
# featureSupport: # featureSupport:
# # MSC2248 - Blurhash # No unstable features are currently supported.
# MSC2448:
# # Whether or not this MSC is enabled for use in the media repo # Support for redis as a cache mechanism
# enabled: false
# #
# # Maximum dimensions for converting a blurhash to an image. When no width and # Note: Enabling Redis support will mean that the existing cache mechanism will do nothing.
# # height options are supplied, the default will be half these values. # It can be safely disabled once Redis support is enabled.
# maxWidth: 1024
# maxHeight: 1024
# #
# # Thumbnail size in pixels to use to generate the blurhash string # See docs/redis.md for more information on how this works and how to set it up.
# thumbWidth: 64 redis:
# thumbHeight: 64 # Whether or not use Redis instead of in-process caching.
# enabled: {{ matrix_media_repo_redis_enabled | to_json }}
# # The X and Y components to use. Higher numbers blur less, lower numbers blur more.
# xComponents: 4 # The database number to use. Leave at zero if using a dedicated Redis instance.
# yComponents: 3 databaseNumber: {{ matrix_media_repo_redis_database_number | to_json }}
#
# # The amount of contrast to apply when converting a blurhash to an image. Lower values # The Redis shards that should be used by the media repo in the ring. The names of the
# # make the effect more subtle, larger values make it stronger. # shards are for your reference and have no bearing on the connection, but must be unique.
# punch: 1 shards:
# {{ matrix_media_repo_redis_shards | to_json | from_json
# # IPFS Support | to_nice_yaml(indent=2, width=999999, sort_keys=false) | indent(width=4, first=true) }}
# # This is currently experimental and might not work at all.
# IPFS:
# # Whether or not IPFS support is enabled for use in the media repo.
# enabled: false
#
# # Options for the built in IPFS daemon
# builtInDaemon:
# # Enable this to spawn an in-process IPFS node to use instead of a localhost
# # HTTP agent. If this is disabled, the media repo will assume you have an HTTP
# # IPFS agent running and accessible. Defaults to using a daemon (true).
# enabled: true
#
# # If the Daemon is enabled, set this to the location where the IPFS files should
# # be stored. If you're using Docker, this should be something like "/data/ipfs"
# # so it can be mapped to a volume.
# repoPath: "./ipfs"
#
# # Support for redis as a cache mechanism
# #
# # Note: Enabling Redis support will mean that the existing cache mechanism will do nothing.
# # It can be safely disabled once Redis support is enabled.
# #
# # See docs/redis.md for more information on how this works and how to set it up.
# redis:
# # Whether or not use Redis instead of in-process caching.
# enabled: false
#
# # The Redis shards that should be used by the media repo in the ring. The names of the
# # shards are for your reference and have no bearing on the connection, but must be unique.
# shards:
# - name: "server1"
# addr: ":7000"
# - name: "server2"
# addr: ":7001"
# - name: "server3"
# addr: ":7002"
{{ matrix_media_repo_feature_support | to_json | from_json | to_nice_yaml(indent=2, width=999999, sort_keys=false) }}
# Optional sentry (https://sentry.io/) configuration for the media repo # Optional sentry (https://sentry.io/) configuration for the media repo
sentry: sentry:
@ -616,4 +588,28 @@ sentry:
environment: {{ "" if matrix_media_repo_sentry_environment == "" else matrix_media_repo_sentry_environment | to_json }} environment: {{ "" if matrix_media_repo_sentry_environment == "" else matrix_media_repo_sentry_environment | to_json }}
# Whether or not to turn on sentry's built in debugging. This will increase log output. # Whether or not to turn on sentry's built in debugging. This will increase log output.
debug: {{ matrix_media_repo_sentry_debug | to_json }} debug: {{ matrix_media_repo_sentry_debug | to_json }}
# Configuration for the internal tasks engine in the media repo. Note that this only applies
# to the media repo process with machine ID zero (the default in single-instance mode).
#
# Tasks include things like data imports/exports.
tasks:
# The number of workers to have available for tasks. Defaults to 5.
numWorkers: {{ matrix_media_repo_tasks_num_workers | to_json }}
# Options for collecting PGO-compatible CPU profiles and submitting them to a hosted pgo-fleet
# server. See https://github.com/t2bot/pgo-fleet for collection/more detail.
#
# If you process more than 1Hz of requests or have more than a dozen media repos deployed, please
# get in contact with `@travis:t2l.io` to submit profiles directly to MMR. Submitted profiles are
# used to improve the build speed for everyone.
pgo:
# Whether collection is enabled. Defaults to false.
enabled: {{ matrix_media_repo_pgo_enabled | to_json }}
# The pgo-fleet submit URL.
submitUrl: {{ matrix_media_repo_pgo_submit_url | to_json }}
# The pgo-fleet submit key.
submitKey: {{ matrix_media_repo_pgo_submit_key | to_json }}

3
roles/custom/matrix-nginx-proxy/templates/nginx/conf.d/matrix-domain.conf.j2
View File

@ -114,6 +114,9 @@
proxy_set_header X-Real-IP $remote_addr; proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $remote_addr; proxy_set_header X-Forwarded-For $remote_addr;
client_body_buffer_size {{ ((matrix_media_repo_max_bytes | int) / 4) | int }};
client_max_body_size {{ matrix_media_repo_max_bytes }};
} }
# Redirect other endpoints registered by the media-repo to its container # Redirect other endpoints registered by the media-repo to its container