+++++++++++++
MASH Services
+++++++++++++

MASH services are deployed using the `mother-of-all-self-hosting/mash-playbook <https://github.com/mother-of-all-self-hosting/mash-playbook/>`_.
This is also where you find a more extensive documentation of this playbook.

Running the playbook
====================

.. warning::

     Only ever run the playbook from this host. It's very important that you always use the latest :code:`vars.yml`.
     By only using the :code:`vars.yml` on this host we can ensure that no changes are made that others are not aware of.


SSH into :code:`urubaen.hyteck.de` as :code:`qzt_admin`. Reach out to Julian if you don't have access to that host yet.

.. hint::

  On Windows, use Putty to access the server.


Navigate to the mash playbook

.. code-block:: bash

  cd mash-playbook

Get the latest version of the playbook and update roles

.. code-block:: bash

  just update

Run the playbook to deploy the configuration, update services and install new ones. In the end all services will be restarted.

.. code-block:: bash

  just install-all

.. hint::

  To access the server, we use a shared SSH-Key. You finde the passphrase for this key in the password manager by searching for "SSH".


Making configuration changes
============================

Let's say you need to change the password of it@queereszentrumtuebingen.de
This e-mail address is used by :doc:`../services/vaultwarden` to send e-mails, so a change of password must be reflected in the configuration.

Open :file:`inventory/host_vars/qz/vars.yml` and make the necessary adjustments. Don't forget to save.

.. code-block:: yaml

    ...
    vaultwarden_config_smtp_username: 'it@queereszentrumtuebingen.de'
    vaultwarden_config_smtp_password: 'VERYSECRET'

.. warning::

     Only make configuration changes in the :code:`vars.yml` on :code:`urubaen.hyteck.de`. All other changes will be overwritten.

To apply the configuration follow the instructions at :ref:`Running the playbook`.