Resposta rápida
Como hospedo um servidor Matrix em uma VPS?
Para hospedar um servidor Matrix em uma VPS, instale o Synapse a partir do repositório apt da Matrix.org, dê a ele um banco PostgreSQL e coloque um proxy reverso HTTPS na porta 443 à frente da sua porta 8008. O plano Gloam da Gloamport, 2 vCPU, 4 GB RAM, 80 GB NVMe, 4 TB traffic a $8.25 por mês no período de 12 meses, é dimensionado para isso.
O que envolve a instalação do Synapse?
| Parte | Configuração | Por quê |
|---|---|---|
| Nome do servidor | O domínio nos IDs de usuário, por exemplo example.com; não pode ser alterado depois | Identidade de federação |
| Pacote | matrix-synapse-py3 a partir de packages.matrix.org | O pacote próprio do Debian não está disponível para Debian 13 e versões anteriores |
| Substituições de configuração | /etc/matrix-synapse/conf.d/ | Atualizações de pacote não perguntam se devem substituir sua configuração |
| Listener de cliente e de federação | HTTP em localhost:8008 atrás de um proxy | O proxy encerra o HTTPS |
| Banco de dados | PostgreSQL (psycopg2) | A documentação diz que o SQLite é aceitável apenas para testes |
| Portas | 443 para clientes; 8448 para federação, a menos que seja delegada ao 443 | As duas precisam estar acessíveis pela internet |
| Plano | Gloam: 2 vCPU, 4 GB RAM, 80 GB NVMe, 4 TB traffic | Lista de planos da Gloamport |
Preços verificados em
O que você precisa antes de instalar um servidor Matrix?
Você precisa de um nome de domínio que controle e de uma VPS com endereço IPv4 público. O domínio importa mais que o servidor: a documentação do Synapse diz que o nome do servidor é a parte do domínio de todo ID de usuário e que ele não pode ser alterado depois. Escolha-o antes de instalar.
Toda VPS da Gloamport vem com um IPv4 e um IPv6 /64 em qualquer plano, então os registros DNS podem apontar diretamente para ela. Um domínio não é vendido aqui; compre-o onde preferir e crie um registro A para o nome de host que você vai usar. Apenas Linux: imagens Debian, Ubuntu, AlmaLinux e Rocky Linux. Sem Windows. Reserve cerca de uma hora para o DNS e o certificado, além da própria instalação.
Como instalar o Synapse no Debian 13 ou no Ubuntu 24.04
Os comandos seguem a documentação oficial do Synapse. Execute-os como root ou com sudo.
Aponte o DNS para a VPS
Crie um registro A para matrix.example.com com o endereço da VPS (e um registro AAAA se você usar IPv6). Aguarde até que ele resolva antes de pedir um certificado.
Adicione o repositório apt da Matrix.org
Baixe a chave de assinatura, adicione a linha do repositório e execute apt update, como no primeiro bloco de código. A documentação informa a impressão digital da chave AAF9AE843A7584B5A3E4CD2BCF45A512DE2DA058; compare-a com o gpg antes de confiar na chave.
Instale o matrix-synapse-py3
Execute apt install matrix-synapse-py3 e defina o nome do servidor quando solicitado. Altere as configurações apenas por meio de arquivos em /etc/matrix-synapse/conf.d/.
Crie o banco de dados PostgreSQL
Instale o PostgreSQL e a biblioteca libpq5, depois crie o usuário e o banco com os comandos do segundo bloco de código e aponte o Synapse para ele com o bloco de banco de dados mostrado ali.
Coloque um proxy reverso à frente
Instale um servidor web, obtenha um certificado para o nome de host e encaminhe /_matrix e /_synapse/client para localhost:8008, como no terceiro bloco de código. Defina x_forwarded: true no listener da porta 8008.
Crie seu usuário e teste
Defina um registration_shared_secret, reinicie o Synapse, execute register_new_matrix_user e depois entre por um cliente Matrix com o endereço do seu homeserver.
sudo apt install -y lsb-release wget apt-transport-https
sudo wget -O /usr/share/keyrings/matrix-org-archive-keyring.gpg https://packages.matrix.org/debian/matrix-org-archive-keyring.gpg
echo "deb [signed-by=/usr/share/keyrings/matrix-org-archive-keyring.gpg] https://packages.matrix.org/debian/ $(lsb_release -cs) main" |
sudo tee /etc/apt/sources.list.d/matrix-org.list
sudo apt update
sudo apt install matrix-synapse-py3sudo apt install postgresql libpq5
sudo -u postgres createuser --pwprompt synapse_user
sudo -u postgres createdb --encoding=UTF8 --locale=C --template=template0 --owner=synapse_user synapse
# /etc/matrix-synapse/conf.d/database.yaml
database:
name: psycopg2
args:
user: synapse_user
password: CHANGE_ME
dbname: synapse
host: localhost
cp_min: 5
cp_max: 10# nginx: inside a server block that listens on 443 ssl for matrix.example.com
location ~ ^(/_matrix|/_synapse/client) {
proxy_pass http://localhost:8008;
proxy_set_header X-Forwarded-For $remote_addr;
proxy_set_header X-Forwarded-Proto $scheme;
client_max_body_size 50M;
}
# Synapse listener on port 8008, in homeserver.yaml or a conf.d file
listeners:
- port: 8008
type: http
x_forwarded: true
bind_addresses: ['127.0.0.1']
resources:
- names: [client, federation]# conf.d/registration.yaml (a random value, kept secret)
registration_shared_secret: "RANDOM_VALUE"
sudo systemctl restart matrix-synapse
register_new_matrix_user -c /etc/matrix-synapse/homeserver.yamlQuanto servidor um homeserver Matrix precisa?
Um homeserver privado para algumas pessoas cabe em um plano intermediário, e é a federação com salas públicas grandes que faz a carga crescer. Não fizemos testes de desempenho do Synapse e não informamos números de usuários. A Gloamport indica o Gloam como o plano para Um servidor Matrix, Vaultwarden e SearXNG juntos: 2 vCPU, 4 GB RAM, 80 GB NVMe, 4 TB traffic, $8.25 por mês no período de 12 meses e $16.50 no plano de um único mês.
Para um chat de equipe com muitas salas, o Night (4 vCPU, 8 GB RAM, 160 GB NVMe, 8 TB traffic, $13.50 por mês no período de 12 meses) é indicado para Um relay movimentado, um servidor de chat de equipe ou vários serviços.
A federação precisa da porta 8448?
Não, a federação pode funcionar pela porta 443 se você delegar. A página de proxy reverso do Synapse informa que, com delegação pela resposta .well-known/matrix/server, a porta 8448 não precisa ser aberta e a federação usa a 443. Sem delegação, a porta padrão de federação é a 8448; então abra-a no firewall e adicione um segundo bloco de servidor que escute ali.
Os clientes podem encontrar seu servidor por meio de um arquivo /.well-known/matrix/client servido em https://nome-do-seu-servidor/.well-known/matrix/client, que indica o homeserver em m.homeserver com seu base_url. Clientes de navegador também precisam de um cabeçalho CORS, e o public_baseurl do Synapse deve conter a mesma URL. Use o nome do servidor no domínio puro apenas se você puder servir esse arquivo ali.
Como manter um servidor Matrix próprio seguro?
Faça cópia de segurança da chave de assinatura, do banco de dados e do armazenamento de mídia, e mantenha o host atualizado. A documentação alerta que as chaves de assinatura devem ser guardadas, porque outros servidores dependem delas. Mensagens em salas sem criptografia ponta a ponta ficam legíveis no banco de dados da sua VPS, então vale considerar a criptografia do disco; Consigo criptografar o disco de uma VPS com LUKS? explica o que a criptografia de disco protege e o que não protege.
Nenhum plano inclui backups: mantenha sua própria cópia de tudo o que você não pode perder. Segundo o levantamento da Gloamport sobre 10 de novembro de 2026, 28 dos 49 provedores não pedem documento de identidade no cadastro; assim, a VPS pode ser comprada sem entregar documentos, mas a segurança do servidor continua sendo sua: SSH somente por chave, como em Como reforço o SSH em uma VPS nova?.
Resumo
- O Synapse é instalado a partir de packages.matrix.org como matrix-synapse-py3.
- O nome do servidor é permanente; escolha o domínio primeiro.
- Use PostgreSQL; a documentação considera o SQLite aceitável apenas para testes.
- Faça proxy de /_matrix e /_synapse/client para localhost:8008 atrás de HTTPS.
- A delegação permite que a federação use a porta 443 em vez da 8448.
- O Gloam, $8.25 por mês no período de 12 meses, é o plano adequado.
- Faça cópia de segurança das chaves de assinatura, do banco e da mídia; nenhum plano inclui backups.
Hospedagem de um servidor Matrix: perguntas frequentes
Preciso de um nome de domínio para a Matrix?
Sim. O nome do servidor faz parte de todo ID de usuário e é definido na instalação. Ele não pode ser alterado depois, então registre ou escolha o domínio antes de instalar.
Por que não usar o SQLite?
A documentação do Synapse diz que o SQLite é aceitável apenas para testes e não deve ser usado em produção. Quase todas as instalações devem usar PostgreSQL.
Onde coloco minhas próprias configurações?
Em arquivos em /etc/matrix-synapse/conf.d/. A documentação recomenda isso para que uma atualização de pacote não pergunte se deve substituir seu arquivo de configuração.
Como crio a primeira conta?
Execute register_new_matrix_user -c com a configuração do homeserver depois que o Synapse estiver rodando. Ele usa o registration_shared_secret, que qualquer pessoa que o conheça pode usar para criar contas, inclusive de administradores.
Posso rodar a Matrix junto com outros serviços?
Sim, em um plano Gloam ou maior. Vaultwarden e SearXNG são pequenos perto dele; veja o guia sobre hospedagem própria do Vaultwarden.
Fontes (3)
- Documentação do Synapse: instruções de instalação — Element / Matrix.org Foundation (checked 2026-11-10)
- Documentação do Synapse: uso de proxy reverso com o Synapse — Element / Matrix.org Foundation (checked 2026-11-10)
- Documentação do Synapse: uso do Postgres — Element / Matrix.org Foundation (checked 2026-11-10)