docker-bitlbee-libpurple

This repo is a fork

NOTE: the alpine image is currently unmaintained.

The images are built and pushed to dockerhub automatically via github workflows.

Included plugins:

• telegram via tdlib-purple
• hangouts via purple-hangouts
• slack via dylex's fork of slack-libpurple
• discord via purple-discord
• rocket.chat via purple-rocketchat
• mastodon via bitlbee-mastodon
• signal via purple-presage
• whatsapp via purple-gowhatsmeow
• microsoft teams via purple-teams
• icyque
• facebook
• steam
• sipe

for mattermost, use matterircd.

for matrix, use matrix2051.

Building and Running

docker build -f ./Dockerfile.debian -t bitlbee-purple .

docker run -p 6667:6667 --name bitlbee -v /local/path/to/configurations:/var/lib/bitlbee --restart=always --detach bitlbee-purple

An example compose file:

services:
  bitlbee:
    image: bitlbee-purple
    deploy:
      resources:
        limits:
          memory: 384M
    logging:
      driver: "json-file"
      options:
        max-size: "100m"
    networks:
      - bitlbeenet
    ports:
      - "127.0.0.1:8667:6667"
      - "172.17.0.1:8667:6667"
    restart: unless-stopped
    user: "bitlbee:bitlbee"
    command:
      [
        "/usr/sbin/bitlbee",
        "-F",
        "-n",
        "-u",
        "bitlbee",
        "-c",
        "/var/lib/bitlbee/bitlbee.conf",
        "-d",
        "/var/lib/bitlbee",
      ]
    volumes:
      - ./conf/bitlbee.conf:/var/lib/bitlbee/bitlbee.conf:ro
      - userdata:/var/lib/bitlbee
networks:
  bitlbeenet:
volumes:
  userdata:

You can use grype to check for CVEs affecting the image:

grype bitlbee-purple --scope all-layers

Debugging

For debugging, you can use the docker compose file provided in the repo. Enable the plugin you want, and run.

This command will run until we crash, after which it will print the backtrace and exit:

command:
  [
    "gdb",
    "-ex",
    "'handle SIGPIPE nostop noprint pass'",
    "-ex",
    "run",
    "-ex",
    "bt",
    "--args",
    "/usr/sbin/bitlbee",
    "-Dnv",
    "-d",
    "/var/lib/bitlbee",
  ]

This command prints debug information for bitlbee:

command:
  [
    "/usr/sbin/bitlbee",
    "-Dnv",
    "-d",
    "/var/lib/bitlbee",
  ]