Rocketchat Server Setup

RocketChat servers are deployed on fairkom's kubernetes cluster. This is a guide for setting up customer instances.

Basic:

• Registrierung überprüfen - Administration/Konten/Anmeldung - eine Angabe einer E-Mail ist nicht nötig
• SMTP-E-Mail, dabei als From Email angeben Vereins-Chat <vereinschat@fairkom.net>
• Berechtigungen überprüfen (z.b. view-outside-room)
• Branding
• Text Startseite
• Texte oder Links Impressum / Datenschutz
• E-Mails (Passwort zurücksetzen etc.)
• Direktnachricht per Mail - Setup IMAP
• Turn off Deeplink url in mail offline Benachrichtigungen
• Invite URL Type / Art des Einladungslinks auf Direkt setzen in /admin/Accounts (ist sonst Proxy über go.rocket.chat)
• Push Gateway

Optional:

• Anbindung an IDP
• Channels anlegen
• Federation in DNS eintragen

Livechat

• Livechat aktivieren
• Agenten definieren
• Widget einbinden (CORS!)

Beispiel Text Startseite

<h1>Willkommen beim Chat</h1>
<br>&nbsp;
<br>&nbsp;
<br>&nbsp;
<br>&nbsp;
<br>&nbsp;
<br>&nbsp;
<br>&nbsp;

<p style="text-align: left;">Für die mobile Nutzung installiere die fairchat App (gibt es für Android und iOS). <br>Gib dabei in der App als Workspace URL ein: https://unserchat.fairchat.net</p>

<p style="text-align: left;">Es gibt private und öffentliche Räume, hier die <a href="https://docs.rocket.chat/guides/user-guides/channels">Anleitung zur Einrichtung</a>. <br>Ein öffentlicher Raum kann auch als Forum zum Beispiel auf der Homepage eingebunden werden (anonymes Lesen ist dabei möglich). </p>

<p style="text-align: left;">Der FREDA Chat basiert auf der Open Source Software rocket.chat und wird gehostet von <a href="https://fairkom.eu">fairkom</a>. <br>Bei Bedarf können noch weitere Features aktiviert werden (Antwortmöglichkeit per E-Mail, Live-Chat, Videokonferenz, ...).</p>

See also example for more advanced and bi-lingual content for start page example.

Checkliste für Firsttime-Setup

• Registrierung überprüfen (bei SSO via keycloak abschalten in admin/Accounts und auch für "Registration with Authentication Services")
• SMTP-E-Mail
• Berechtigungen überprüfen (z.b. view-outside-room)
• Anbindung an IDP
• Branding
• E-Mails (Passwort zurücksetzen etc.)
• Channels anlegen
• Direktnachricht per Mail
• Turn off Deeplink url in mail offline Benachrichtigungen
• Passwortänderung etc. abschalten wenn mit IDP verbunden
• Einladungslink auf direkt setzen (in admin/Accounts)
• fairkom push gateway (sofern Vereinbarung dafür vorhanden, Nutzer verwenden dann die fairchat app)