Open Infrastructure

h1. Ungleich Matrix-as-a-Service (MaaS)

*%{color:red}This document concerns end-users/customers. See [[The ungleich Matrix infrastructure]] page for server-side documentation.%*

h2. Status

This document is *A DRAFT*. *%{color:red}The MaaS offer has not been released yet%.*

h2. Overview

TODO: explain what MaaS is.

h2. FAQ

h3. What are application services, can I use them?

Matrix support a variety of external services (bridges to IRC, Telegram, Mattermost, ...) integrated via the Application Service API. ungleich do not support any of them 'officialy' yet but you can contact our support for a personalized deployment.

h3. What will be the server name?

You can either use your own domain name (see below) or ask us for $ANYTHING.???.??. 

h3. Can I use a custom domain?

Yes! You will have to give us two domain names:

* (A) The base server name, used in the MXIDs (e.g. ungleich.ch).

  - You will have to serve a file containing *{"m.server": "address_of_B:443"}* on *.well-known/matrix/server*. Example: <pre>$ curl https://ungleich.ch/.well-known/matrix/server

{"m.server": "matrix.ungleich.ch:443"}</pre>

* (B) An address for the Matrix server and client (e.g. matrix.ungleich.ch).

  - You will have to add a DNS A record poiting to 185.203.112.54

  - You will have to add a DNS AAAA record pointing to an IPv6 address dedicated to your deployment.

h3. What server implementation and version do you use?

We use the "synapse reference homeserver":https://github.com/matrix-org/synapse/ package "provided by the buster-backports repository":https://packages.debian.org/buster-backports/matrix-synapse.

h3. What client can I use?

We recommend and provide you a web version of the "Riot client":https://about.riot.im/ (desktop and mobile) but you can use "any matrix client":https://matrix.org/clients/.

h3. Can I set option X in synapse/riot?

Yes! Contact the ungleich support with details on the options you want us to enable,

h3. Do you provide a TURN server for VoIP?

Not yet, but it is planned.