[PT]
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.
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]
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.
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