config.yml.sample

port: 8080
sentry_dsn: '' # optional sentry dsn
public: # public-facing information
  name: MRS # instance name
  ui: http://localhost # UI URL
  api: https://localhost:8080 # public API URL
matrix: # matrix server information
  server_name: localhost # server name (!), not api url
  support: # MSC1929 support file
    contacts:
      - matrix_id: '@admin:example.com' # matrix ID
        email_address: 'admin@example.com' # email
        role: 'm.role.admin' # role
    support_page: "https://example.com" # (optional) support page URL
  keys: [] # keys, will be generated automatically on first run
search: # search config
  defaults: # default options, if not provided by request
    limit: 10
    offset: 0
    sort_by: "-_score" # by relevancy (desc)
auth: # auth configuration
  admin: # admin configuration
    login: admin
    password: changeme
    ips: # (optional) allow access to admin endpoints only from the following IPs
      - 127.0.0.1
  metrics: # metrics endpoints
    login: metrics
    password: changeme
    ips: # (optional) allow access to metrics endpoint only from the following IPs
      - 127.0.0.1
  discovery: # (optional) protected discovery endpoint without rate limit
    login: discovery
    password: changeme
    ips: # (optional) allow access to discovery endpoints only from the following IPs
      - 127.0.0.1
  moderation: # moderation endpoints
    login: moderation
    password: changeme
    ips: # (optional) allow access to moderation endpoints only from the following IPs
      - 127.0.0.1
cache: # (optional) cache config
  max_age: 0
  max_age_search: 0 # /search and /_matrix/federation/v1/publicRooms should have different max-age that aligns with full and/or index cron jobs
  bunny: # (optional) bunny cdn cache purging, ref: https://docs.bunny.net/reference/pullzonepublic_purgecachepostbytag
    url:
    key:
plausible: # (optional) plausible.io integration
  host: plausible.io
  domain: example.com
cron: # (optional) data jobs, using cron synax, ref: https://github.com/mileusna/crontab#crontab-syntax-
  discovery:
  parsing:
  indexing:
  full:
path:
  index: testdata/index
  data: testdata/data.db
batch: # batch size of ingested data
  rooms: 10000
workers: # parallelism configuration, how much workers to spin up at once
  discovery: 20 # matrix server discovery, servers at once
  parsing: 20 # matrix public rooms parsing, servers at once
webhooks: # optional webhooks
  moderation: 'hookshot webhook url'
  stats: 'hookshot webhook url'
email: # (optional) email integration, for now only for automatic reporting using MSC1929
  moderation: 'moderation email address'
  postmark: # only postmark is supported for now
    server_token: your server token
    report:
      message_stream: postmark message stream ID
      from: email, usually a postmark sender signature
  templates: # (optional) email templates using go tempates: https://pkg.go.dev/text/template
    report: # report is used when sending automatic email to the server admins using MSC1929 contacts
      subject: "{{ .Public.Name }}: Room {{ .RoomAliasOrID }} has been reported"
      body: |-
        Hello,

        The room [{{ .RoomAliasOrID }}](https://matrix.to/#/{{ .RoomAliasOrID }}) has been reported on [{{ .Public.Name }}]({{ .Public.UI }}) (a [Matrix Rooms Search](https://gitlab.com/etke.cc/mrs/api) instance).

        The reporter provided the following reason:

        ```
        {{ .Reason }}
        ```

        ---

        This automatic email was sent by [{{ .Public.Name }}]({{ .Public.UI }}) (a [Matrix Rooms Search](https://gitlab.com/etke.cc/mrs/api) instance) because you listed that email address as contact point (Matrix MSC1929 proposal). If you have any questions - please, use the [{{ .Public.Name }}]({{ .Public.UI }}) website.

languages: # (optional) list of supported languages in ISO 639-1 format. if first element is "ALL" - all models will be loaded
  - EN
  - DE

# bootstrap list of servers, each of them will be discovered and if server doesn't respond, it won't be parsed
servers:
  - etke.cc

# blocklist config
blocklist:
  servers: [] # list of servers to ignore completely
  queries: [] # list of words, if at least one of them is present in a search query, empty results will be returned

# vi: ft=yaml