This document lists the requirements and steps to run TLG_JoinCaptchaBot in a docker container.
-
docker. If possible, install it using your OS native packaging system (under Debian based systems, use
apt-get install docker-ce). -
GNU Make, which should be installed on most Linux distributions by default.
Create a new bot on Telegram using The BotFather. Make sure your bot can be invited to channels and has privacy set to disabled. Without this, the bot won't be able to read messages on the channel.
Save the bot token. The token should not publicly visible as anyone with it could take control of your bot instance. We'll use the token to create the docker image containing the bot (below).
Create a docker image:
make BOT_TOKEN="<your_bot_token_here>"
It is also possible to specify a different default language for the bot to use
by setting the BOT_LANG variable at build time, like:
make BOT_TOKEN="<your_bot_token_here>" BOT_LANG="PT_BR"
The build process may take a while, depending on your computer and connection speeds. Docker will indicate a successful build at the end of the process with something like:
Successfully built (number)
Successfully tagged captcha-bot:latest
Note on token security: A little bit of paranoia never hurts! Once your
container has been built, remove the lines from your bash history containing
your token. This can be accomplished with the history -d command on
individual lines. An easier (but coarser) approach is to run history -c,
followed by history -r. This will clear the history buffer and re-read the
history from disk.
To run an instance, use:
docker run -d --name captcha-bot captcha-bot
This will start the container in the background. Use docker ps to check if
the container is up and running, and docker logs captcha-bot to
investigate the logs.
To stop the bot, use
docker stop captcha-bot
docker rm captcha-bot