1 [[!meta title="Switching to KGB from CIA"]]
3 [CIA.vc](http://cia.vc) has unfortunately
4 [disappeared](http://shadowm.rewound.net/blog/archives/245-CIA.vc-is-dead.html),
5 and is [unlikely to return](http://pastebin.com/9RBBniM1) any time
6 soon. I personally have decided to switch to
7 [KGB](http://kgb.alioth.debian.org/), but other alternatives such as
8 [FBI](http://fbi.github.com) and
9 [irker](http://www.catb.org/esr/irker/) exist.
12 To switch, you first need to find or set up a kgb bot. If this is a
13 Debian associated FOSS project, feel free to contact me or join
14 \#kgb-devel on irc.oftc.net and ask for someone to allow your project
15 to talk to their bot. Once you've found a bot, we need to set up the
16 client. [I'll talk about bot set up at the end.]
18 kgb-client configuration
19 ------------------------
21 Install the `kgb-client` and `kgb-client-git` packages. Currently, kgb
22 only supports subversion, git, and cvs, but support for additional
23 VCSes continue to be added as kgb gains popularity.
25 For git repositories, add a post-receive hook like the following:
28 tee hooks/reflog | kgb-client --conf /path/to/kgbclient.conf --repository git --git-reflog -
30 For subversion repositories, add a post-commit hook like the following:
33 kgb-client --conf /path/to/kgbclient.conf --repository svn "$1" "$2"
35 Then update the configuration file `/path/to/kgbclient.conf`:
38 repo-id: my-repository
40 - uri: http://servername:9999/
42 # optional link to a website where the commits are;
43 # needs newish kgb-client and server
44 web-link: http://example.com/?p=my-repository;a=commitdiff;h=${commit}
46 Then, send the bot owner the password, repo-id, channel, and network
47 you'd like the changes to be reported to.
52 The bots just listen to soap requests and if the password matches,
53 sends the commit to the appropriate IRC channel. To set one up,
56 Then, enable the bot (set `BOT_ENBALED=1` in `/etc/default/kgb-bot`),
57 and configure the bot's configuration file `/etc/kgb-bot/kgb.conf`:
65 log_file: "/var/log/kgb-bot.log"
67 # just a name to identify it
69 # needs to be the same on the client
77 nickserv_password: yournickservpassword
85 nickserv_password: yournickservpassword
86 server: irc.freenode.net
89 - name: '#your-channel'
99 Then start the bot (`/etc/init.d/kgb-bot start`), and watch as it
100 joins channels and reports your changes!
102 You'll probably actually want to register whatever nick you are using
103 on the networks, etc... but you can figure that out yourself!
106 [[!tag debian tech kgb]]