---
title: Charmhub | Deploy IRC Bridge using Charmhub - The Open Operator Collection
description: Deploy the latest version of IRC Bridge on any cloud. IRC Bridge charm
  for Matrix.
url: https://charmhub.io/irc-bridge
---

# IRC Bridge

[Canonical IS DevOps](https://charmhub.io/publisher/canonical-is-devops "View all packages from Canonical IS DevOps")

* [Canonical IS DevOps](https://charmhub.io/publisher/canonical-is-devops "View all packages from Canonical IS DevOps")

Platform:

22.04

edge b7e97982

```
juju deploy irc-bridge --channel edge
```

[Learn to deploy on juju >](https://juju.is/docs/juju/manage-applications)

---

#### Relevant links

* [Contact](https://launchpad.net/~canonical-is-devops)

---

#### Contacts

##### Maintainers

+ [Launchpad Team](https://launchpad.net/~canonical-is-devops)

* [Submit a bug](https://github.com/canonical/irc-bridge-operator/issues)

---

Share your thoughts on this charm with the community on discourse.

[Join the discussion](https://discourse.charmhub.io/)

# IRC Bridge Operator

A [Juju](https://juju.is/) [charm](https://documentation.ubuntu.com/juju/3.6/reference/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](https://github.com/canonical/synapse-operator) and related
to it.

## [High-level overview of IRC Bridge](https://charmhub.io/irc-bridge#p-37546-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](https://charmhub.io/irc-bridge#p-37546-get-started)

To begin, refer to the [Deploy IRC Bridge](https://charmhub.io/irc-bridge/docs/tutorial-deploy-irc-bridge) tutorial for step-by-step instructions.

## [Integrations](https://charmhub.io/irc-bridge#p-37546-integrations)

* [HAProxy](https://charmhub.io/haproxy): HAProxy is a TCP/HTTP reverse proxy which is particularly suited for high availability environments.
* [PostgreSQL](https://charmhub.io/postgresql): PostgreSQL is a powerful, open source object-relational database system.
* [Synapse](https://charmhub.io/synapse): Synapse is an open-source homeserver that is part of the [Matrix.org](http://Matrix.org) Foundation. Matrix is an open standard for communications on the internet, supporting federation, encryption and VoIP.

## [Learn more](https://charmhub.io/irc-bridge#p-37546-learn-more)

* [Read more](https://charmhub.io/irc-bridge)
* [Developer documentation](https://github.com/matrix-org/matrix-appservice-irc/blob/develop/CONTRIBUTING.md)
* [Official webpage](https://github.com/matrix-org/matrix-appservice-irc/tree/develop)
* Troubleshooting

## [Project and community](https://charmhub.io/irc-bridge#p-37546-project-and-community)

* [Issues](https://github.com/canonical/irc-bridge-operator/issues)
* [Contributing](https://github.com/canonical/irc-bridge-operator/blob/main/CONTRIBUTING.md)
* [Matrix](https://matrix.to/#/#charmhub-charmdev:ubuntu.com)

---

[Help improve this document in the forum](https://discourse.charmhub.io/t/irc-bridge-documentation-overview/17755) ([guidelines](https://discourse.charmhub.io/t/how-to-write-docs-our-documentation-guidelines-for-contributors/1245)). Last updated 1 year, 1 month ago.