matrix-room-directory-server

README

matrix-room-directory-server

A minimal implementation of a room directory server for Matrix, using a Space as a backend.

Support room: #matrix-room-directory-server:t2bot.io

Caution: Although this claims to be a room directory server, it is not yet recommended for full-featured deployment. Check the github issues before deploying.

Building and running

This project does not provide any guidelines on how to run this in your infrastructure. It is up to you to determine how best to deploy this, and how much of it actually gets deployed.

The process is meant to be run only attached to a postgres instance and does not have any on-disk requirements other than the executable itself.

You will need to be running or otherwise have access to a matrix-key-server. This project also expects that you have extensive knowledge on how to set up an application service for your server, as demonstrated by the program arguments.

This project uses Go modules and requires Go 1.17 or higher. To enable modules, set GO111MODULE=on.

# Build
git clone https://github.com/t2bot/matrix-room-directory-server.git
cd matrix-room-directory-server
go build -v -o bin/matrix-room-directory-server

# Run
./bin/matrix-room-directory-server \
    -keyserver="https://keys.t2host.io" \
    -address="0.0.0.0" \
    -port=8080 \
    -space="#directory:example.org" \
    -accesstoken="syt_randomstringfromserver" \
    -hsurl="https://t2bot.io"

Docker

docker run -it --rm \
    -e "ADDRESS=0.0.0.0" \
    -e "PORT=8080" \
    -e "KEYSERVER=https://keys.t2host.io" \
    -e "HSURL=https://t2bot.io" \
    -e "SPACE=#directory:example.org" \
    -e "ACCESSTOKEN=syt_randomstringfromserver" \
    t2bot/matrix-room-directory-server

Build your own by checking out the repository and running docker build -t t2bot/matrix-room-directory-server .