Back to articles
DevOps & Systems

Automating Internal End-to-End Encrypted Chat Servers with Matrix Synapse and Element Web on VPS

A technical guide to deploying a secure, self-hosted internal chat system with end-to-end encryption (E2EE) using Matrix Synapse and Element Web on a VPS. The guide covers setup,...

DPTCloud Engineering4 min read
Automating Internal End-to-End Encrypted Chat Servers with Matrix Synapse and Element Web on VPS

This technical guide provides a step-by-step approach to deploying a secure, self-hosted internal chat system with end-to-end encryption (E2EE) using Matrix Synapse and Element Web on a VPS. The solution leverages open-source, self-managed technology ideal for modern software development and system administration needs. The guide covers setup, configuration, optimization, and troubleshooting.

Overview of Matrix and E2EE Ecosystem

Matrix is an open communication protocol for real-time messaging, voice, and video. It supports end-to-end encryption (E2EE), where data is encrypted on the sender’s device and only decrypted on the recipient’s device, ensuring high security. Synapse is the reference Matrix server, deployable on VPS or physical servers. Element Web is a popular web-based Matrix client compatible with Synapse. Automating the deployment and configuration on a VPS reduces operational risks and improves efficiency.

Prerequisites and Environment Preparation

To deploy Matrix Synapse and Element Web on a VPS, you need:

  • A Linux-based VPS (Ubuntu 20.04/22.04 or Debian 11/12)
  • A static IP address
  • A domain name pointing to the VPS IP
  • Necessary software: Docker, Nginx, Certbot (for SSL certificates)

Choose a VPS with sufficient resources to run these services. Refer to the NVMe Cloud VPS for Docker, Nginx & Databases guide for detailed setup.

Installation and Configuration

Run the following commands on the VPS to install Synapse and Element Web using Docker:

mkdir -p /opt/matrix
cd /opt/matrix
# Create docker-compose.yml
cat > docker-compose.yml << 'EOF'
version: '3.8'
services:
  synapse:
    image: matrixdotorg/synapse:latest
    container_name: matrix_synapse
    volumes:
      - ./data:/data
    ports:
      - "8008:8008"
    environment:
      - SYNAPSE_SERVER_NAME=yourdomain.com
      - SYNAPSE_REPORTING=false
    restart: unless-stopped
  element-web:
    image: matrixdotorg/element-web:latest
    container_name: matrix_element
    ports:
      - "80:80"
    environment:
      - MATRIX_SERVER_NAME=yourdomain.com
      - MATRIX_HOMESERVER_URL=https://yourdomain.com
    restart: unless-stopped
EOF
# Start services
docker-compose up -d

After startup, access https://yourdomain.com to use Element Web. E2EE is enabled by default in Synapse. To verify, create a new account and send a message to yourself.

Testing and Troubleshooting

To ensure the system functions correctly:

  • Test Synapse connectivity: curl -k https://yourdomain.com/_matrix/federation/v1/version
  • Fix SSL certificate issues: Run certbot certonly --webroot -w /var/www/html -d yourdomain.com and configure Nginx to use the certificate.
  • Verify E2EE: In Element Web, go to Settings, select "Security & Privacy", and ensure "Enable end-to-end encryption" is enabled.

If issues occur, check Synapse logs: docker logs matrix_synapse. Refer to the Centralized Logging Management with ELK Stack guide for system log monitoring.

For deeper exploration of Matrix and deployment, consult:

DPTCloud Tier III Infrastructure

Recommended NVMe Cloud VPS Plans to Deploy This Setup

Enterprise RAID 10 NVMe SSDs, CMC & FPT District 9 uplinks with Anycast Anti-DDoS and 99.99% SLA.

View 22 VPS Plans
ECO · vn-02

VPS-2E

94.600 ₫ / mo

10% VAT included

  • CPU: 2 vCPU
  • RAM: 2 GB
  • SSD: 30 GB NVMe
ECO · vn-02Recommended

VPS-3E

170.500 ₫ / mo

10% VAT included

  • CPU: 2 vCPU
  • RAM: 4 GB
  • SSD: 50 GB NVMe
BASIC · vn-01Recommended

VPS-05

457.600 ₫ / mo

10% VAT included

  • CPU: 4 vCPU
  • RAM: 8 GB
  • SSD: 50 GB NVMe

Related Articles

View all
ZaloZalo SupportDiscord0384 753 478