docker-bitlbee

Features

• In addition to the Bitlbee's out of the box supported protocols, this container also supports the following protocols:

  • Skype via skype4pidgin
  • Telegram via telegram-purple
  • Facebook (MQTT) via bitlbee-facebook
  • Google Hangouts via purple-hangouts
  • Mastodon via bitlbee-mastodon
  • Rocket.Chat via purple-rocketchat
  • Discord via bitlbee-discord
  • Slack via slack-libpurple
  • Steam via bitlbee-steam
  • Matrix via purple-matrix
  • Mattermost via puple-mattermost
  • Instagram via purple-instagram

• The docker-compose.yml provided in this repository enables bitlbee to be TLS terminated via stunnel.

Usage

1. Clone the project:

   % git clone https://www.github.com/mbologna/docker-bitlbee
   

2. (Optional) Customize bitlbee configuration file in etc/bitlbee/bitlbee.conf

3. Start bitlbee either via:

   • Docker Compose (recommended):

     % docker-compose up
     

   • Docker:

     % docker volume create bitlbee_data
     % docker run -d --name bitlbee \
                     --restart=always \
                     -p 16667:6667 \
                     -v $PWD/etc/bitlbee:/usr/local/etc/bitlbee \
                     mbologna/docker-bitlbee
     % docker run -d --name bitlbee-stunnel \
                     --restart=always \
                     --link bitlbee:bitlbee
                     -e STUNNEL_SERVICE=bitlbee-stunnel \
                     -e STUNNEL_ACCEPT=6697 \
                     -e STUNNEL_CONNECT=bitlbee:6667 \
                     -p 16697:6697 \
                     dweomer/stunnel
     

4. Connect your IRC client either to:

   • localhost:16697 (TLS terminated) (recommended)
   • localhost:16667 (non-TLS, plain connection)

Building

You can build a bitlbee image from Dockerfile: docker build -t="mbologna/docker-bitlbee" github.com/mbologna/docker-bitlbee