====== Matrix ======
One of our hosted [[Apps]]

^ Status     | labs     |
^ Developers | [[Jade]] |

===== Learning resources =====

Matrix is a server chat protocol. Details available at [[https://matrix.org|matrix.org]]. The specific server implementation we are using is Synapse.

Synapse:
  * [[https://matrix-org.github.io/synapse/latest/welcome_and_overview.html|Installation documentation]]
  * [[https://github.com/spantaleev/matrix-docker-ansible-deploy|matrix-docker-ansible-deploy]] is a set of ansible scripts we may be able to just use.

===== Infrastructure Provisioning =====

Infrastructure is provisioned using our [[Terraform Repo]].

===== Server Configuration =====

We use the following git repo for ansible configuration:
[[https://github.com/merri-bek-tech/ansible-app-matrix|ansible-app-matrix]]

The ansible scripts are executed using:

<code>
just roles
just setup-all
</code>

==== Upgrading ====

To upgrade the server, clone our github repository (above) and add a remote called upstream for https://github.com/spantaleev/matrix-docker-ansible-deploy.git , your remotes should look like this:

<code>
git remote -v

origin	git@github.com:merri-bek-tech/ansible-app-matrix.git (fetch)
origin	git@github.com:merri-bek-tech/ansible-app-matrix.git (push)
upstream	https://github.com/spantaleev/matrix-docker-ansible-deploy.git (fetch)
upstream	https://github.com/spantaleev/matrix-docker-ansible-deploy.git (push)
</code>

Then, pull from upstream, using rebase as your pull merge strategy.

Then run:

<code>
just roles
just setup-all
</code>