Matrix - federacyjny komunikator z szyfrowaniem end-to-end. Własny homeserver Synapse i klient webowy Element pod jedną domeną, rozmowy z użytkownikami matrix.org przez federację.
Środowisko
| Runtime | Oficjalne obrazy Docker matrixdotorg/synapse (homeserver) i vectorim/element-web (klient webowy), dedykowany kontener PostgreSQL i nginx rozdzielający ruch, pliki .well-known obsługiwane przez nginx aplikacji (federacja przez port 443) |
| Zalecany plan | Box M+ (Docker, cztery kontenery, min 1,5 GB RAM) |
Przykładowy saplo.yaml
Plik saplo.yaml w katalogu głównym repozytorium opisuje, jak Saplo ma zbudować i uruchomić aplikację. Wygeneruje go też komenda saplo init.
version: 1
name: my-matrix
stack: matrix-synapse
app_id: 1234
Pełny opis wszystkich pól znajdziesz na stronie Plik saplo.yaml.
Jak wdrożyć
Ten stack wdrożysz na trzy sposoby - wybierz wygodny dla siebie:
- Z panelu - tworzysz aplikację klikami, kod wgrywasz później przez CLI lub Git.
- Saplo CLI - z katalogu projektu:
saplo init, potemsaplo deploy. - Deploy z GitHub - podłączasz repo raz, każdy push wdraża się sam.
# Najszybsza droga - z katalogu projektu
$ npm install -g @saplo/cli
$ saplo login
$ saplo init
$ saplo deploy
Dobrze wiedzieć
- Stawiasz z panelu jednym kliknięciem - Saplo instaluje Docker CE, cztery kontenery (baza, homeserver, klient, proxy) i zakłada konto administratora.
- Konto administratora ma login "admin", hasło znajdziesz w pliku MATRIX-SETUP.txt w katalogu aplikacji - zmień je po pierwszym zalogowaniu.
- Domena aplikacji staje się częścią identyfikatora kont (@użytkownik:twoja-domena.pl) - nie zmieniaj jej po założeniu kont, bo stare identyfikatory przestaną działać.
- Rejestracja nowych kont przez www jest domyślnie wyłączona - kolejne konta zakładasz komendą register_new_matrix_user (dokładna komenda jest w pliku MATRIX-SETUP.txt).
- Szyfrowanie end-to-end włącza się per pokój w kliencie - zapisz klucz odzyskiwania i zweryfikuj inne urządzenia, inaczej nie odzyskasz historii po utracie urządzenia.
- Aplikacje mobilne i desktopowe Element łączą się tym samym kontem: jako serwer podajesz domenę aplikacji, dane logowania te same co w przeglądarce.
Czas na deploy?
Wybierz plan Box i postaw aplikację Matrix Synapse + Element jeszcze dziś.
