Differences

This shows you the differences between two versions of the page.

Link to this comparison view

Both sides previous revisionPrevious revision
Next revision		Previous revision
on-boarding [2021/09/16 18:50] – [Collaboration tools] ntnsndron-boarding [2025/02/06 15:26] (current) – [Matrix chat] ntnsndr
Line 2: Line 2:
  
 Welcome to MEDLab! The purpose of this page is to help you get set up in all our processes. Welcome to MEDLab! The purpose of this page is to help you get set up in all our processes.
 +
 +MEDLab is a dynamic community, and there is no one-size-fits-all way to be involved. The best way to find your place in MEDLab is to come to weekly meetings, discuss your work with the director, and get involved in at least one of our projects.
 +
 +If you're looking for the more intellectual side of on-boarding, check out our [[background_reading|background readings]].
  
 ===== Collaboration tools ===== ===== Collaboration tools =====
  
-First, you'll need to get plugged into our self-managed collaboration tools. Remind Nathan to send you an invitation to create an account through Cloudron at ''my.medlab.host''.+First, you'll need to get plugged into our self-managed collaboration tools. Learn more about our tools on the [[technology|Technology]] page.
  
-At NextCloud (''cloud.medlab.host''), you'll find most of what you need. If you don't see the folder '''MEDLab Master''' in your home folder, let Nathan know and he'll add you to the MEDLab circle, which will give you access.+  * Nathan needs to send you an invitation to create an account through Cloudron at ''my.medlab.host''. This is your main account, which grants access to all the other tools.
  
-To enter our chat space, go to the Element button at the top of the NextCloud Web interface, or go to ''cloud.medlab.host/riotchat''. You can also access it via the [[https://element.io/get-started|Element desktop or mobile app]], using ''matrix.medlab.host'' as the server.+==== Nextcloud ====
  
-  * When you first create an account, use the same credentials you used for NextCloud. +Nextcloud is an open-source, multi-purpose cloud platform. At our Nextcloud instance (''cloud.medlab.host''), you'll find most of what you need to participate in MEDLab online. 
-  * You'll also probably be asked to generate a big, ugly security key. Please do so and keep it in a safe place. This enables encrypted communications. You should then be logged in. + 
-  * Set up your account by clicking on your username in the top-left corner of the Web interface. Choose "All settings," and add your preferred name and photo and email address.+  * Log in at ''cloud.medlab.host'' with the credentials you created at ''my.medlab.host'' 
 +  * Ask Nathan to add you to the MEDLab group, which will give you access to our shared files 
 + 
 +You can also access our server via the Nextcloud mobile app, though it is not as fully featured as the web interface. 
 + 
 +==== Matrix chat ==== 
 + 
 +Matrix is an open-source, privacy-friendly chat platform. The best-supported client for Matrix is called [[https://element.io/get-started|Element]] (available for desktop, mobile, or on the web), or you can use one of the [[https://matrix.org/ecosystem/clients/|many other clients]] as well. On any client, just be sure to use ''matrix.medlab.host'' as the homeserver if you are using a MEDLab account. 
 + 
 +We have our own instance of Element on our Nextcloud. To log in there, click the Element button at the top of the Nextcloud desktop interface, or go to ''https://cloud.medlab.host/apps/riotchat/''. ("Riot" was the old name of Element, and the Nextcloud app is apparently stuck with it.) 
 + 
 +Here are the steps for setting up your Matrix account (assuming you are already logged into Nextcloud at ''cloud.medlab.host/apps/riotchat''): 
 + 
 +Logging in: 
 + 
 +  * Choose the "Sign in" option and then "Continue with MEDLab Clouds" 
 +  * Log in using the same credentials you created already for Cloudron and used for Nextcloud 
 +  * You'll probably be asked to generate a big, ugly security key. Please do so and keep it in a safe place (like a password manager). This enables encrypted communications. You should then be logged in. 
 + 
 +Getting set up: 
 + 
 +  * Set up your account by clicking on your username in the top-left corner of the web interface. Choose "All settings," and add your preferred name and photo and email address.
   * On the sidebar in that menu, choose Notifications and turn on the "Enable email notifications" slider. This is important so that you know when someone at MEDLab is attempting to reach you through the chat.   * On the sidebar in that menu, choose Notifications and turn on the "Enable email notifications" slider. This is important so that you know when someone at MEDLab is attempting to reach you through the chat.
 +  * Be sure to add ''matrix.app@medlab.host'' to your contacts in your email system. Otherwise notifications will likely go to spam.
   * Fill out any other settings you'd like to adjust and close out of the settings dialog.   * Fill out any other settings you'd like to adjust and close out of the settings dialog.
-  * Choose which rooms you want to join by pressing the compass button right under your name in the top-left of the Web interface. Be sure you're in #general, as well as the rooms related to any projects you're part of or interested in. 
  
-See more information about our tech stack on the [[Technology]] page.+Joining the MEDLab Space: 
 + 
 +  * A Space in Matrix is a collection of chatrooms. 
 +  * Ask Nathan to invite you to the [[https://cloud.medlab.host/apps/riotchat/#/room/!ODXsCLxXpycGkFBclI:medlab.host|MEDLab Space]], which will give you access to all our rooms. 
 +  * Choose which rooms you want to join by pressing the compass button right under your name in the top-left of the web interface. Be sure you're in #general, as well as the rooms related to any projects you're part of or interested in.