Enter the Matrix Bridges

Enter the Matrix Bridges

[PT]

Workshop gratuito, mediante a registo prévio em https://mill.pt/events/enter-the-matrix-bridges/

Objetivo
Instalar e configurar um servidor Matrix com bridges (pontes) num VPS, utilizando um playbook Ansible mantido pela comunidade.

Não é objetivo
Fornecer orientações completas para construir um sistema seguro.

Aviso
Este não é um workshop sobre privacidade ou segurança, embora esses temas inevitavelmente surjam nas discussões.
O sistema resultante não será seguro a menos que já tenhas uma forte consciência sobre segurança.
Esta configuração não será privada — a organização que gere o protocolo bridged ou os servidores continuará a ter acesso aos teus metadados. A intenção é reduzir essa exposição onde for possível e aumentar a consciência sobre o tema.

Conceitos

Matrix: Um protocolo de comunicação seguro e distribuído.

Servidor Matrix: O teu ponto de entrada na rede Matrix, que pode opcionalmente federar com outros servidores Matrix.

Servidor Matrix federado: Um servidor que pode comunicar com outros dentro do ecossistema Matrix.

Bridge Matrix: Um plugin para o servidor Matrix que o liga a outras plataformas de mensagens (ex.: WhatsApp, Discord, IRC), permitindo comunicação unificada através do Matrix.

VPS (Servidor Virtual Privado): Uma máquina virtual alojada online, sob o teu controlo.

Ansible: Uma ferramenta de automação para aprovisionamento, instalação, configuração e orquestração de software e infraestruturas.

Visão geral do workshop

Este workshop está dividido em dois dias e públicos diferentes. Podes trazer amigos no segundo dia.

Dia 1: Mergulho Técnico

Uma sessão prática e técnica focada na configuração do servidor e dos serviços.

Requisitos:

  • À vontade com a linha de comandos num sistema Unix-like

  • Entendimento básico de DNS e serviços web

  • Aceitação de que “a vida é sofrimento” (e fazer debugging também)

  • Capacidade de ler e escrever ficheiros YAML

Tópicos:

  • Aprovisionamento de um VPS e nomes de domínio

  • Equilíbrio entre privacidade, segurança e conveniência

  • Introdução ao Ansible

  • Mãos na massa com o básico do Ansible

  • Introdução ao Matrix e às bridges

  • Utilização do playbook Ansible para Matrix

Dia 2: Traz Amigos

Convida amigos, partilha o acesso e explora o uso prático do servidor.

Requisitos:

  • Um servidor funcional do Dia 1
    ou

  • Um amigo com um servidor funcional do Dia 1

  • Registos DNS devidamente configurados

Tópicos:

  • Resolução de problemas e manutenção do servidor

  • Segundo aviso sobre privacidade, por precaução

  • Introdução ao Matrix do ponto de vista do utilizador

  • Criação de contas e festa de configuração das bridges 🎉

Orientador: 

Daniel photonbit

Poeta, artista cognitivo, vidente

Atualmente investigador independente em arquitetura de metadados, normas geoespaciais, e na interligação entre o eu e os outros.

No passado trabalhou como administrador de sistemas, programador, atendimento ao cliente, arquiteto, gestor de produto, articulador de processos, e responsável espiritual.

Hello, human

Condições: Consulte as condições por dia.

Idioma: Maioritariamente devido à natureza técnica do workshop, o idioma principal será o inglês, mas podemos ajudar as pessoas que não sejam tam fluentes.

Local: MILL – Makers in Little Lisbon
Data: Dois dias, Domingo 29 de Junho e Domingo 6 Julho, 14h-19h

[EN]

Free workshop, subject to prior registration at https://mill.pt/events/enter-the-matrix-bridges/

Goal
Install and configure a Matrix server with bridges on a VPS using a community-maintained Ansible playbook.

Non-Goal
Provide comprehensive guidance to building a secure system.

Disclaimer
This is not a workshop about privacy or security, though those topics will inevitably arise in discussion.
The resulting system will not be secure unless you already have strong security awareness.
This setup will not be private — the organization behind the bridged protocol or servers may still access your metadata. The intent is to reduce exposure where possible and raise awareness.

Key Concepts

Matrix: A secure, distributed communication protocol.

Matrix Server: Your entry point into the Matrix network, which can optionally federate with other Matrix servers.

Federated Matrix Server: A server that can communicate with others across the Matrix ecosystem.

Matrix Bridge: A plugin for a Matrix server that connects it to other messaging platforms (e.g. WhatsApp, Discord, IRC), enabling unified communication through Matrix.

VPS (Virtual Private Server): A virtual machine hosted online that you control.

Ansible: An automation tool for provisioning, deploying, configuring, and managing infrastructure and software.

Workshop Overview

This workshop is split into two days, aimed at different audiences. You’re welcome to bring friends on the second day.

Day 1: The Deep Dive

A technical, hands-on session focused on setting up the server and services.

Requirements:

  • Comfortable using a Unix-like shell

  • Basic understanding of DNS and web services

  • Acceptance that “life is suffering” (and so is debugging)

  • Ability to read and write YAML

Topics:

  • Provisioning a VPS and domain names

  • Privacy–Security–Convenience trade-offs

  • Introduction to Ansible

  • Hands-on with Ansible basics

  • Introduction to Matrix and bridges

  • Using the Matrix Ansible playbook

Day 2: Bringing Others

Invite friends, share access, and explore real-world usage.

Requirements:

  • A functioning server from Day 1
    or

  • A friend with a functioning server from Day 1

  • All necessary DNS records configured

Topics:

  • Troubleshooting and maintaining your server

  • A second privacy disclaimer, just in case

  • Introduction to using Matrix as a user

  • Account creation and bridge configuration party 🎉

Instructor: 

Daniel photonbit

Poet, cognitive artist, seer

Now an independent researcher of metadata architecture, geospatial standards, entangled self & others.

In the past worked as sysadmin, programmer, customer service, architect, product manager, process spinner, spiritual officer.

Hello, human

Conditions: See the requirements per day

Language: Mainly due to the technical nature of the workshop, the main language will be English, but we can assist people who are not fluent.

Location: MILL – Makers in Little Lisbon
Date: Two days, Sunday June 29th and Sunday July 6th, 14h-19h

9 days ago
MILL
Calçada do Moinho de Vento, 14B, Lisboa