Ungleich Matrix-as-a-Service (MaaS) » History » Revision 11
Revision 10 (Timothée Floure, 03/20/2020 02:09 PM) → Revision 11/53 (Nico Schottelius, 07/13/2020 08:58 PM)
h1. Ungleich Matrix-as-a-Service (MaaS)
{{toc}}
*%{color:green}This document concerns end-users/customers. See [[The ungleich Matrix infrastructure]] page for server-side documentation.%*
h2. Status
This document is *in PRODUCTION*
h2. Overview
"Matrix":https://matrix.org/ is an open and decentralized IM system supporting modern features such as end-to-end encryption, message history, bridging to other networks, VoIP and more. It is based a federated structure, similar to what is done with emails: users use a home server as 'gateway' to the network. Our MaaS offer provides you with such a server as well as an hosted web client, "Riot":https://about.riot.im/.
"Riot's features page"https://about.riot.im/features gives you a good overview of Matrix's possibilities.
h2. FAQ
h3. Q: How many users can I have? What are the resources allocated to my matrix server?
We do not enforce a limit of the number of users: you can do anythign you want as long as you fit the resources allocated to your homeserver. You are provided with 1GB of memory, 1vCPU and 20GB of storage with the base offer, which can be extended on demand (Pricing is the same as ipv6onlyhosting VMs, since that's what we use underneath).
h3. Q: What server name will I get?
You can either use your own domain name (see below) or ask us for $ORGANIZATION.0co2.cloud.
h3. Q: Can I use a custom domain name?
Yes! You will have to give us three two domain names:
* a) *the homeserver*: this is where the actual (A) The base server is running - this can be on domain "A" - name, used in case of ungleich we use ungleich.matrix.ungleich.cloud and give away YOURNAME.matrix.ungleich.cloud for free
* b) *the address of the web client* MXIDs (e.g. ungleich.ch).
- this is where people with their webbrowser go to - this should be different from "A". Often this is something like *chat.example.org* or *matrix.example.org*. In case of ungleich this domain is matrix.ungleich.ch.
* c) *the main matrix domain*: the one you use for users and rooms. This is usually your main domain and is different from A. For ungleich this is ungleich.ch. Most people will choose their "main domain", for instance *example.org* here.
You will also need have to configure 2 files below *the main matrix domain*
- */.well-known/matrix/server* serve a file containing *{"m.server": "address_of_B:443"}*.
"address_of_B:443"}* on *.well-known/matrix/server*. Example: <pre>$ curl https://ungleich.ch/.well-known/matrix/server
{"m.server": "ungleich.matrix.ungleich.cloud:443"}</pre>
* (B) An address for the Matrix server and client (e.g. matrix.ungleich.ch).
- */.well-known/matrix/client* containing *{ "m.homeserver": { "base_url": "https://ungleich.matrix.ungleich.cloud" } }*. Example: <pre>
curl https://ungleich.ch/.well-known/matrix/client
{ "m.homeserver": { "base_url": "https://ungleich.matrix.ungleich.cloud" } }
</pre>
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. Q: 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. Q: What client can I use? Do you recommend one?
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. Q: Can I set option X in synapse/riot?
Yes! Contact the ungleich support with the requested changes, which we will apply to the deployment configuration of your instance.
h3. Q: Do you provide a TURN server for VoIP?
Yes.
h3. Q: What are application services can I use?
We support bridging to other services (IRC, Matrix, Telegram, Slack, ...) via "matterbridge":https://github.com/42wim/matterbridge, deployed on demand.
h3. Q: If I do not use an LDAP directory, can I still manage my users?
Yes! We provide you with a management UI on https://admin.matrix.ungleich.cloud. You will have to use the full address of your matrix homeserver (e.g. ungleich.matrix.ungleich.cloud).