Установка Matrix Synapse и Element на свой сервер

Как установить Matrix Synapse через Docker с PostgreSQL по шагам#

Короткий путь: создать сервер из маркетплейса, где есть связка Synapse с Element (371 установка на 14 октября 2026). Для ручной установки на Ubuntu или другой Linux нужны только Docker и домен.

1. Создайте файл настроек командой generate: она запишет homeserver.yaml и ключи в каталог data.
2. Положите рядом compose-файл с двумя сервисами, Synapse и PostgreSQL.
3. Замените блок database в homeserver.yaml: вместо SQLite укажите psycopg2 и хост db.
4. Проверьте registration_shared_secret в том же файле, он нужен для создания пользователей из консоли.
5. Запустите и создайте пользователя, ключ -a делает его администратором.

docker run -it --rm -v $PWD/data:/data \
  -e SYNAPSE_SERVER_NAME=example.com -e SYNAPSE_REPORT_STATS=no \
  matrixdotorg/synapse:latest generate

services:
  db:
    image: postgres:16
    restart: unless-stopped
    environment:
      POSTGRES_USER: synapse
      POSTGRES_PASSWORD: change-me
      POSTGRES_DB: synapse
      POSTGRES_INITDB_ARGS: "--encoding=UTF8 --lc-collate=C --lc-ctype=C"
    volumes:
      - ./pgdata:/var/lib/postgresql/data
  synapse:
    image: matrixdotorg/synapse:latest
    restart: unless-stopped
    depends_on: [db]
    volumes:
      - ./data:/data
    ports:
      - "127.0.0.1:8008:8008"

database:
  name: psycopg2
  args:
    user: synapse
    password: change-me
    database: synapse
    host: db

docker compose up -d
docker compose exec synapse register_new_matrix_user http://localhost:8008 -c /data/homeserver.yaml -a

Ещё 1 абзац · 10 сек

Element для браузера и телефонов: подключение к своему Synapse#

Element Web это статический сайт: его раздаёт любой веб-сервер или контейнер, а в config.json указывают адрес вашего Synapse в параметре base_url. Приложения Element для Android и iOS при входе спрашивают домен вашего сервера, отдельных настроек в магазинах не нужно.

Ещё 2 абзаца · 20 сек

Вопросы об установке Matrix Synapse#

Как установить Matrix Synapse через Docker?

Выполните команду generate образа matrixdotorg/synapse с переменными SYNAPSE_SERVER_NAME и SYNAPSE_REPORT_STATS, подключите PostgreSQL в homeserver.yaml и запустите compose-файл. Приложение слушает порт 8008.

Какой порт использует Matrix Synapse?

В контейнере Synapse слушает HTTP на порту 8008. Снаружи нужны 80 и 443 на обратном прокси, а порт 8008 держите на локальном адресе.

Как создать пользователя в Matrix Synapse в Docker?

Убедитесь, что в homeserver.yaml задан registration_shared_secret, и выполните register_new_matrix_user внутри контейнера с адресом http://localhost:8008 и путём к конфигу /data/homeserver.yaml. Ключ -a делает пользователя администратором.

Подойдёт ли SQLite для Matrix Synapse?

SQLite стоит в настройках по умолчанию, но документация образа советует для рабочего сервера подключить отдельную базу PostgreSQL.

Нужен ли Element, чтобы пользоваться Synapse?

Нет, Synapse это сервер, а клиентом может быть любое приложение Matrix. Element самый распространённый и ставится вместе с Synapse из маркетплейса.