Public | Automated Build

Last pushed: 3 months ago
Short Description
Docker image for The Inner Circle's Google Hangouts chat bot.
Full Description

docker-icbot

Docker image for The Inner Circle's Google Hangouts chat bot -- built on
HangoutsBot.


Prerequisites

Running the Container

Create a named data volume

In order to persist configuration data through container upgrades we need to
create a named data volume (not required but highly recommended):

docker volume create --name icbot-data

First run & authentication

The first time you run the bot you have to authenticate it manually. To do
this run the bot interactively and follow the instructions provided:

docker run -it --rm -v icbot-data:/etc/hangoutsbot theinnercircle/icbot

Running the bot

Once authenticated you can use Ctrl + C to kill the running container and run
a daemonized bot container:

docker run -dt -v icbot-data:/etc/hangoutsbot --name icbot theinnercircle/icbot
Optional 'docker run' Arguments

-e TZ=America/Phoenix - Set the timezone for your server. You can find your timezone in this
list of timezones. Use the (case sensitive)
value from the TZ column. If left unset, timezone will be UTC.

--restart unless-stopped - Always restart the container regardless of the exit status, but do not
start it on daemon startup if the container has been put to a stopped
state before. See the Docker restart policies
for additional details.

Modifying the Config

The bot configuration can be modified by editing the config.json file in the
running container:

docker exec -it icbot vi /etc/hangoutsbot/config.json

After saving your changes and exiting the editor, restart the running container
to apply the changes:

docker retstart icbot

Plugin Development

To test a single plugin during development you can mount your plugin file or
folder via a docker volume (the -v switch) to a temporary container running
in the foreground:

docker run -it --rm -v icbot-data:/etc/hangoutsbot -v /path/to/plugins/plugin_name.py:/opt/hangoutsbot/hangupsbot/plugins/plugin_name.py theinnercircle/icbot

Troubleshooting

Please report bugs to the GitHub Issue Tracker.

Copyright

This project is licensed under the MIT License.

Docker Pull Command
Owner
theinnercircle
Source Repository

Comments (0)