{{ :matrix_idea.jpg?300&direct}}[[https://matrix.org/|Matrix]] is an open source, decentralised, modern and secure instant messaging protocol that allows you to connect to hacklab's instant messaging channels as well as many other platforms via so-called [[https://matrix.org/bridges/|Bridges]]. In simple terms, the Matrix server is connected to a web browser or a separate client program. There are several [[https://matrix.org/clients|different]] of them. One of the most used clients is [[https://element.io/|Element]]. The Element application is available for most platforms and operating systems, so we recommend using it for beginners.

The Hacklab.fi umbrella organization maintains the Matrix [[https://matrix.hacklab.fi/|server]], which you can log in to with your member register credentials (SSO/Keycloak).

You can find more information about Matrix in Suomi language at [[https://www.linux.fi/wiki/Matrix|here]].

==== Hacklab.fi Matrix user ID implementation ====

When you become a member of Tampere Hacklab ry, a membership ID will be created for you [[..:my.tampere.hacklab.fi|in the member register]]. With this ID you can log in to most of the services offered by the association, as well as to the hacklab.fi matrix server. The technology behind it is called single sign-on (aka. single sign on for short. SSO) and [[https://www.keycloak.org/|Keycloak]]. You may come across these terms when logging in. \\ {{:sso_login.png?400&nolink}}\\ Above is an example of a single sign-on window.

\\

==== Element for Mobile devices ====


  - Install the Element app. **Please note that you do not need to create a new account during installation !**\\ \\ [[https://apps.apple.com/app/vector/id1083446067|{{:palvelut:appstore.png?x150}}]] [[https://play.google.com/store/apps/details?id=im.vector.app|{{:palvelut:getitongoogleplay_badge_web_color_english.png?x150}}]] [[https://f-droid.org/repository/browse/?fdid=im.vector.app|{{:palvelut:get_it_on_f-droid-_badge-p-500.png?x150}}]] \\ ‎ 
  - Configure Element by pressing the button\\ \\ [[https://app.element.io/?hs_url=https://hacklab.fi|{{:palvelut:configure_element.png?150}}]] 
  - Check that the server is changed to hacklab.fi (NOT matrix.org which is the default)
  - Scroll to the bottom of the login window and select Hacklab SSO login \\ \\ {{:tunnukset.png?500&direct}}
  - Select Tampere and log in with your [[https://my.tampere.hacklab.fi/|member registration ID]].
  - Logging in requires a token. ** [[?oauthlogin=keycloak|Click here]]** to log in to the Wiki and view your registration token.

{nodisp 2}<code>Poletti: HL3U6feOvkYC
</code>{/nodisp}



==== Desktop browser ====

|<100% 350px>|
| {{:desktop_welcome.png?350&direct|Welcome page}} | 1. **In your browser, go to** [[https://chat.hacklab.fi/]] \\ \\ 2. **Log in** |
| {{:desktop_login.png?350&direct|Login page}} | 3. **Continue using the service provider**\\ **hacklab finland keycloak**\\ |
| {{:desktop_login_with_sso_keycloak.png?350&direct|SSO Keycloak page}} | 4. **Tampere** |
| {{:desktop_login_mylusa.png?350&direct|member register login}} | 5. **Log in to the service using your member registration mulysa ID**\\ \\ 6. **Start messaging** [[https://wiki.tampere.hacklab.fi/en/jasenen_ohje|in the channels]] |

**Mobile Browser  --  //Mobile Browser//**\\  NOTE! Don't do it. But, if you [[https://wiki.tampere.hacklab.fi/hidden|do]].\\

\\

==== Element Desktop app ====

Below are instructions for setting up device-specific Element applications and logging into the hacklab.fi matrix server.

**Element desktop app --  //Desktop//**\\

  * Download and install the Element app [[https://element.io/get-started#download]]
  * Open the app
  * Click the “Sign in” button.
  * Edit the home server address by clicking “Edit”
  * Select and enter the server address in the “Other homeserver” field hacklab.fi
  * Click the “Continue” button.
  * Enter your existing hacklab.fi credentials or log in with your membership register credentials by clicking the “Continue using the service provider Hacklab Finland Keycloak”/“Sign in with Hacklab Finland Keycloak” button.
  * Help developers by activating reporting
  * Join [[https://matrix.to/#/!bffXHgwxURCYIvOXlg:hacklab.fi?via=hacklab.fi&via=matrix.org|Tampere Hacklab-avaruuteen]], below which you will find the lab's channels.
  * Join and start communicating [[https://wiki.tampere.hacklab.fi/palvelut#liity_kanaville|in the channels]].

{{::desktop_login.jpg?225&direct}} {{:valitse_palvelin.png?220&direct}} {{:matrix.hacklab.fi.png?185&direct}} {{:tunnukset.png?235&direct}} \\ 

**Element mobile app  --  //Mobile//** \\

  * Download and install the Element app [[https://element.io/get-started#download]]
  * Open the app
  * Click the “I already have an account” button
  * Click on select server “other”
  * Enter the server address hacklab.fi
  * Click the “Continue” button.
  * Enter your existing hacklab.fi credentials or log in with your membership registration credentials “Sign in with Hacklab Finland Keycloak”.
  * Help developers by activating reporting
  * Join [[https://matrix.to/#/!bffXHgwxURCYIvOXlg:hacklab.fi?via=hacklab.fi&via=matrix.org|Tampere Hacklab-avaruuteen]], below which you will find the lab's channels.
  * Join and start messaging [[https://wiki.tampere.hacklab.fi/palvelut#liity_kanaville|in the channels]].

{{::minulla_on_jo_tunnus.jpg?200&direct}}{{:valitse_palvelin_other.jpg?200&direct}}{{:matrix.hacklab.fi.jpg?200&direct}}{{:kayttajatunnukset_tai_sso.jpg?200&direct}}{{:auta_kehittajia.jpg?200&direct}}

=== More detailed instructions ===

== Setting up a new hacklab.fi account (advanced users) ==

NOTE! As a member of Tampere Hacklab ry, you have automatically been given a member register ID. You can use the member register ID to log in to the hacklab.fi matrix server. To get started go to - [[https://wiki.tampere.hacklab.fi/palvelut#pikaohje_selainsovellus|quick info]]. Täällä ohjeet [[https://wiki.tampere.hacklab.fi/matrix/erikoistapaukset|special cases]].

== Alternative Matrix ID ==

If you wish, you can use any matrix server credentials when joining hacklab's instant messaging channels. However, it is recommended to use the @tunnus:hacklab.fi credentials from the member registry (single sign-on, SSO/Keycloak).

= Hacklab.fi matrix Bridges = With bridges, Matrix users can reach other instant messaging platforms such as IRC , Telegram, Whatsapp, Facebook messenger, Signal, SMS, Slack and Discord. [[https://github.com/hacklab-fi/itinfra/blob/master/matrix/matrix-general.md|More information on bridges]].

== Tampere Hacklab channels ==

[[..:palvelut:verkko#pikaviestinkanavat|Wiki page: Instant messaging channels]]

More Finnish-language channels on various topics have been collected [[https://matrix.to/#/!WDaMZSVinTZRLOTajM:hacklab.fi?via=hacklab.fi&via=matrix.org&via=kapsi.fi|in this space]].

== Matrix customers ==

It is worth downloading the Element app for smartphones:

  *  [[https://play.google.com/store/apps/details?id=im.vector.app&hl=fi|Android - version]]
  *  [[https://itunes.apple.com/us/app/vector.im/id1083446067|iOS - version]]

On a computer, you can use [[https://element.io/|element.io]] browser or desktop versions.

There are many other Matrix apps to suit all tastes. Here is [[https://matrix.org/docs/projects/clients-matrix|a list of well-known Matrix apps]].