Difference between revisions of "SAC:Heisenbridge"

From OSGeo
Jump to navigation Jump to search
(update heisenbridge version)
(add info about adding auto-op to the bot)
 
Line 1: Line 1:
Heisenbridge is an IRC <-> Matrix bridge that we are running on an [[SAC_Service_Status#matrix|LXC container]]
+
[https://github.com/hifi/heisenbridge Heisenbridge] is an IRC <-> Matrix bridge that we are running on an [[SAC_Service_Status#matrix|LXC container]]
 
hosted on [[SAC Service Status#osgeo3|osgeo3]] machine and administered by the [[SAC|OSGeo System Administration Committee]].
 
hosted on [[SAC Service Status#osgeo3|osgeo3]] machine and administered by the [[SAC|OSGeo System Administration Committee]].
  
The bridge registeres as an app service with the OSGeo [[SAC:MatrixSynapse]] homeserver.
+
The bridge registers as an app service with the OSGeo [[SAC:MatrixSynapse]] homeserver.
  
 
The configuration and install of the bridge is driven by Ansible (restricted access): https://git.osgeo.org/gitea/sac/ansible-deployment
 
The configuration and install of the bridge is driven by Ansible (restricted access): https://git.osgeo.org/gitea/sac/ansible-deployment
  
 
At time of writing this the running Heisenbridge version is 1.14.6
 
At time of writing this the running Heisenbridge version is 1.14.6
 +
 +
== Bridging IRC channels ==
 +
 +
Bridging IRC channels with Matrix rooms is a manual operation that is done by interacting with a bot Matrix user.
 +
 +
Only the admin user can interact with the bot, the current allowed user is set via an HEISENBRIDGE_OWNER_MXID variable in ansible, and is currently set to @strk:osgeo.org - the bot supports "help" commands to figure how to do things.
 +
 +
On the IRC side it is helpful to grant auto-op to the bridge user.
 +
Bridge user on libera.chat is registered as "osgeo-matrix", and you can grant it auto-op on IRC channels with:
 +
 +
    /msg ChanServ flags #<channelname> osgeo-matrix +O
 +
 +
Granting operator status to the bot allows automatic synchronization of the IRC channel topic with the Matrix Room description.
  
 
[[Category:Infrastructure]]
 
[[Category:Infrastructure]]
 
[[Category:Services]]
 
[[Category:Services]]

Latest revision as of 02:41, 24 January 2025

Heisenbridge is an IRC <-> Matrix bridge that we are running on an LXC container hosted on osgeo3 machine and administered by the OSGeo System Administration Committee.

The bridge registers as an app service with the OSGeo SAC:MatrixSynapse homeserver.

The configuration and install of the bridge is driven by Ansible (restricted access): https://git.osgeo.org/gitea/sac/ansible-deployment

At time of writing this the running Heisenbridge version is 1.14.6

Bridging IRC channels

Bridging IRC channels with Matrix rooms is a manual operation that is done by interacting with a bot Matrix user.

Only the admin user can interact with the bot, the current allowed user is set via an HEISENBRIDGE_OWNER_MXID variable in ansible, and is currently set to @strk:osgeo.org - the bot supports "help" commands to figure how to do things.

On the IRC side it is helpful to grant auto-op to the bridge user. Bridge user on libera.chat is registered as "osgeo-matrix", and you can grant it auto-op on IRC channels with:

    /msg ChanServ flags #<channelname> osgeo-matrix +O

Granting operator status to the bot allows automatic synchronization of the IRC channel topic with the Matrix Room description.