matrix-docker-ansible-deploy/docs/configuring-playbook-bridge-appservice-irc.md

# Setting up Appservice IRC (optional)

The playbook can install and configure [matrix-appservice-irc](https://github.com/matrix-org/matrix-appservice-irc) for you.

See the project's [documentation](https://github.com/matrix-org/matrix-appservice-irc/blob/master/HOWTO.md) to learn what it does and why it might be useful to you.

You'll need to use the following playbook configuration:

```yaml
matrix_appservice_irc_enabled: true

matrix_appservice_irc_ircService_servers:
  irc.example.com:
    name: "ExampleNet"
    port: 6697
    ssl: true
    sasl: false
    allowExpiredCerts: false
    sendConnectionMessages: true
    botConfig:
      enabled: true
      nick: "MatrixBot"
      joinChannelsIfNoUsers: true
    privateMessages:
      enabled: true
      federate: true
    dynamicChannels:
      enabled: true
      createAlias: true
      published: true
      joinRule: public
      groupId: +myircnetwork:localhost
      federate: true
      aliasTemplate: "#irc_$CHANNEL"
    membershipLists:
      enabled: false
      floodDelayMs: 10000
      global:
        ircToMatrix:
          initial: false
          incremental: false
        matrixToIrc:
          initial: false
          incremental: false
    matrixClients:
      userTemplate: "@irc_$NICK"
      displayName: "$NICK (IRC)"
      joinAttempts: -1
    ircClients:
      nickTemplate: "$DISPLAY[m]"
      allowNickChanges: true
      maxClients: 30
      idleTimeout: 10800
      reconnectIntervalMs: 5000
      concurrentReconnectLimit: 50
      lineLimit: 3
```

You then need to start a chat with `@irc_bot:YOUR_DOMAIN` (where `YOUR_DOMAIN` is your base domain, not the `matrix.` domain).
Add support for matrix-appservice-irc 2019-01-31 13:37:23 +08:00			`# Setting up Appservice IRC (optional)`

Fix matrix-appservice-irc database specification This fixes an incorrect indentation in the database specification for appservice-irc which caused matrix-appservice-irc to refuse to start with the remarkably unhelpful error message: ``` ERROR:CLI Failed to run bridge. ``` This also updates doc links to the new matrixdotorg repo because the tedomum repo contains out-of-date documentation. 2020-02-08 18:02:03 +08:00			`The playbook can install and configure [matrix-appservice-irc](https://github.com/matrix-org/matrix-appservice-irc) for you.`
Add support for matrix-appservice-irc 2019-01-31 13:37:23 +08:00
Fix matrix-appservice-irc database specification This fixes an incorrect indentation in the database specification for appservice-irc which caused matrix-appservice-irc to refuse to start with the remarkably unhelpful error message: ``` ERROR:CLI Failed to run bridge. ``` This also updates doc links to the new matrixdotorg repo because the tedomum repo contains out-of-date documentation. 2020-02-08 18:02:03 +08:00			`See the project's [documentation](https://github.com/matrix-org/matrix-appservice-irc/blob/master/HOWTO.md) to learn what it does and why it might be useful to you.`
Add support for matrix-appservice-irc 2019-01-31 13:37:23 +08:00
			`You'll need to use the following playbook configuration:`

			```yaml
Correct variable name in documentation 2019-01-31 23:58:45 +08:00			`matrix_appservice_irc_enabled: true`
Make IRC bridge configuration entirely managed by the playbook 2019-06-19 17:28:58 +08:00
			`matrix_appservice_irc_ircService_servers:`
			`irc.example.com:`
			`name: "ExampleNet"`
			`port: 6697`
			`ssl: true`
			`sasl: false`
			`allowExpiredCerts: false`
			`sendConnectionMessages: true`
			`botConfig:`
			`enabled: true`
			`nick: "MatrixBot"`
			`joinChannelsIfNoUsers: true`
			`privateMessages:`
			`enabled: true`
			`federate: true`
			`dynamicChannels:`
			`enabled: true`
			`createAlias: true`
			`published: true`
			`joinRule: public`
			`groupId: +myircnetwork:localhost`
			`federate: true`
			`aliasTemplate: "#irc_$CHANNEL"`
			`membershipLists:`
			`enabled: false`
			`floodDelayMs: 10000`
			`global:`
			`ircToMatrix:`
			`initial: false`
			`incremental: false`
			`matrixToIrc:`
			`initial: false`
			`incremental: false`
			`matrixClients:`
			`userTemplate: "@irc_$NICK"`
			`displayName: "$NICK (IRC)"`
			`joinAttempts: -1`
			`ircClients:`
			`nickTemplate: "$DISPLAY[m]"`
			`allowNickChanges: true`
			`maxClients: 30`
			`idleTimeout: 10800`
			`reconnectIntervalMs: 5000`
			`concurrentReconnectLimit: 50`
			`lineLimit: 3`
Add support for matrix-appservice-irc 2019-01-31 13:37:23 +08:00			```

Rename some variables 2019-02-28 17:51:09 +08:00			You then need to start a chat with `@irc_bot:YOUR_DOMAIN` (where `YOUR_DOMAIN` is your base domain, not the `matrix.` domain).