irc-bridge

IRC Bridge

Channel Revision Published Runs on
latest/edge 41 08 Dec 2025
Ubuntu 22.04
juju deploy irc-bridge --channel edge
Show information

Platform:

Ubuntu
22.04

IRC Bridge Operator

A Juju charm deploying and managing an IRC Bridge (with Ident server) Integrator on bare metal.

This charm is meant to be used in conjunction with Synapse and related to it.

High-level overview of IRC Bridge

The IRC Bridge is implemented as an Application Service, as defined in the Matrix specification. This means it interacts with Synapse through the Application Service API, allowing it to manage virtual users, handle messages and bridge communications between Matrix and IRC efficiently.

Integrations overview:

  • User → Synapse: The user connects to the Matrix homeserver (Synapse) via HTTPS (port 443).
  • Synapse → HAProxy: Synapse routes traffic to HAProxy via HTTPS (port 443).
  • HAProxy → IRC Bridge: HAProxy forwards Matrix-IRC traffic to the bridge using HTTP (port 8090).
  • IRC Bridge → IRC: The bridge connects to the IRC network using TLS (port 6697).
  • IRC Bridge → PostgreSQL: It stores relevant data in PostgreSQL via TCP (port 5432).
  • IRC Bridge ↔ Synapse: Maintains communication with Synapse over HTTPS (port 443).
  • IRC → IRC Bridge: The IRC server connects back to the bridge via Identd (port 1113) for user identity verification.

Get started

To begin, refer to the Deploy IRC Bridge tutorial for step-by-step instructions.

Integrations

  • HAProxy: HAProxy is a TCP/HTTP reverse proxy which is particularly suited for high availability environments.
  • PostgreSQL: PostgreSQL is a powerful, open source object-relational database system.
  • Synapse: Synapse is an open-source homeserver that is part of the Matrix.org Foundation. Matrix is an open standard for communications on the internet, supporting federation, encryption and VoIP.

Learn more

Project and community


Help improve this document in the forum (guidelines). Last updated 3 months ago.