docker-bitlbee/README.md

bitlbee Dockerfile

This repository contains Dockerfile of bitlbee, for Docker's automated build published to the public Docker Hub Registry.

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

Base Docker image

• buildpack-deps/stretch-curl

Installation

1. Install Docker.

2. Download automated build from public Docker Hub Registry: docker pull mbologna/docker-bitlbee

   (alternatively, you can build an image from Dockerfile: docker build -t="mbologna/docker-bitlbee" github.com/mbologna/docker-bitlbee)

Usage

1. (optional and only for those who build the image) configure bitlbee

customize etc/bitlbee/bitlbee.conf to suit your needs

2. run bitlbee via:

   a. Docker Compose:

    `docker-compose up`
   

   b. or via Docker:

    - without persistent configuration:
   
        `docker run -d --name bitlbee -p 16667:6667 --restart=always mbologna/docker-bitlbee`
   
    - with persistent configuration store in volume:
   
        `docker run -d --name bitlbee -p 16667:6667 --restart=always -v <data-dir>:/var/lib/bitlbee mbologna/docker-bitlbee`
   

Contributing

1. Fork it
2. Create your feature branch (git checkout -b my-new-feature)
3. Commit your changes (git commit -am 'Add some feature')
4. Push to the branch (git push origin my-new-feature)
5. Create new Pull Request