README.md


1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70

# docker-bitlbee-libpurple

This docker image includes bitlbee with a bunch of useful plugins:
  - [facebook](https://github.com/jgeboski/bitlbee-facebook)
  - [steam](https://github.com/jgeboski/bitlbee-steam)
  - [skypeweb](https://github.com/EionRobb/skype4pidgin)
  - [telegram](https://github.com/majn/telegram-purple)
  - [hangouts](https://bitbucket.org/EionRobb/purple-hangouts)
  - [slack](https://github.com/dylex/slack-libpurple)
  - [sipe](https://github.com/tieto/sipe)
  - [discord](https://github.com/sm00th/bitlbee-discord)
  - [rocket.chat](https://bitbucket.org/EionRobb/purple-rocketchat)
  - [mastodon](https://github.com/kensanata/bitlbee-mastodon)
  - [matrix](https://github.com/matrix-org/purple-matrix)
  - [signal](https://github.com/hoehermann/libpurple-signald)

The most significant being the [libpurple Slack plugin](https://github.com/dylex/slack-libpurple). As Slack is turning off its IRC gateway on May 15 2018, now is the time to spin up your own docker image and start using bitlbee instead.

## Building and running the image
Build the image and tag it:
```bash
docker build -t bitlbee:latest .
```

Then run it:
```bash
docker run -p 6667:6667 --name bitlbee -v /local/path/to/configurations:/var/lib/bitlbee \
   --restart=always --detach bitlbee:latest
```

The local path to the configurations will contain the configuration as saved by 
bitlbee. It is advisable to do so, as your configuration will be gone when
the docker image gets deleted.

## Setting up a Slack account
Connect with your IRC client to the host running the image. Then register with a password in the &bitlbee channel:
```
/join &bitlbee
register <your password>
```

Then, go to [the Slack legacy token site](https://api.slack.com/custom-integrations/legacy-tokens) to acquire
an API token, which is necessary in order to log in.

Copy the token, register your slack account in bitlbee and enable the account:
```
account add slack yourusername@whatever.slack.com thetoken
account on
```

This should log your account in right away:
```
<@root> Trying to get all accounts connected...
<@root> slack - Logging in: Requesting RTM
<@root> slack - Logging in: Connecting to RTM
<@root> slack - Logging in: RTM Connected
<@root> slack - Logging in: Loading Users
<@root> slack - Logging in: Loading conversations
<@root> slack - Logging in: Logged in
```

By default, none of the channels you normally reside in will be joined. To join them, you first need to add them:
```
<@you> chat add slack general
<@root> Chatroom successfully added.
```

Don't add the leading #. Adding private channels works the same way as public channels, both without the leading #.
Now, join the channel with /join #channnelname and you'll be good to go.