IMAP Mon

Tool for monitoring IMAP mailboxes and retransmitting received emails via alternative channels

Quick start

1. Create a file docker-compose.override.yml or update docker-compose.yml with environment variables defined below.
2. Start the app with:

   docker-compose up
   

Settings

Some options can be set via an environment variable (real or dotenv) or a command line flag.

Examples

0. Get help:

   imapmon --help
   

1. Passing parameters via a command-line:

   imapmon --hostname imap.example.com -u user@example.com -p qwerty123 -c telegram --telegram-bot-token "1234567890:EtneWwZtnEibpH6WZVsnZimbPXZLRurw" --telegram-chat-id "12345678"
   

2. Passing parameters via environment variables:

   export IMAP_HOSTNAME=imap.example.com
   export IMAP_USERNAME=user@example.com
   export IMAP_PASSWORD=qwerty123
   CHANNELS=telegram TELEGRAM_BOT_TOKEN=xxx TELEGRAM_CHAT_ID=123 imapmon
   

3. Run using a pre-built Docker image:

   docker run --rm -it \
       docker.pkg.github.com/soar/imapmon/imapmon:latest \
       --hostname imap.example.com \
       -u user@example.com \
       -p qwerty123 \
       ...