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

# 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)

---

#### 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/)

# How to troubleshoot IRC bridge issues

This section will help you troubleshoot various issues with the IRC bridge charm.

## [Synapse stops sending events to the IRC bridge](https://charmhub.io/irc-bridge/docs/how-to-troubleshooting#p-38223-synapse-stops-sending-events-to-the-irc-bridge)

This section details the issue when Synapse stops sending events to the IRC bridge.

### [Symptoms](https://charmhub.io/irc-bridge/docs/how-to-troubleshooting#p-38223-symptoms)

* Synapse is unable to push `appservice` transactions to the IRC bridge.
* Synapse logs may indicate errors such as “Server not known” or
  appservice-specific warnings.
* The database shows `appservice_stream_position` stuck at an old event, and
  restarting Synapse does not resolve the issue.
* Logs from Synapse may contain warnings similar to:

  ```
  push_bulk to https://chat.example.com/irc threw exception(JSONDecodeError): Expecting value: line 1 column 1 (char 0)
  ```

### [Root cause](https://charmhub.io/irc-bridge/docs/how-to-troubleshooting#p-38223-root-cause)

The `appservice_stream_position` in the Synapse database can get stuck on a
problematic event, causing the `appservice` sender to break silently and stop
processing new events.

### [Solution](https://charmhub.io/irc-bridge/docs/how-to-troubleshooting#p-38223-solution)

1. **Back up the Synapse database**:
   Before making any changes, ensure you have a full backup of your Synapse
   database to prevent data loss.

   Find more details about the backup in [How to Backup and Restore](https://charmhub.io/synapse/docs/how-to-backup-and-restore).
2. **Update the `appservice_stream_position`**:
   Run the following SQL query to update the `appservice_stream_position`
   to the latest event:

   ```
   UPDATE appservice_stream_position
   SET stream_ordering = (SELECT MAX(stream_ordering) FROM events);
   ```
3. **Restart Synapse**:
   After executing the query, restart the Synapse service to apply the changes.

### [Additional notes](https://charmhub.io/irc-bridge/docs/how-to-troubleshooting#p-38223-additional-notes)

* This solution skips the problematic event and allows Synapse to resume
  sending events to the IRC bridge.
* If the issue persists, check the Synapse logs for additional errors or
  misconfigurations.
* In this [IRC-Bridge issue](https://github.com/matrix-org/matrix-appservice-irc/issues/1222), you can find more details about the error.

---