MFTP continuously monitors the CDC Noticeboard and forwards incoming notices to the configured email address, whether it's an individual account or a Google Group. It is also available as a service and as a cronjob on linux systems along with a heath checkup utility to monitor and notify for any errors.

(back to top)

To set up a local instance of the application using docker, follow the steps below.

The following requirements are to be satisfied for the project to function properly:

• For mftp
• For mftp doctor

(back to top)

1. Clone the repository and cd into it

   git clone https://github.com/metakgp/mftp
   cd mftp

2. Follow the installation steps for mftp with docker
3. Follow the installation steps for mftp doctor with docker

(back to top)

It is mandatory to provide all of the following env variables before the docker-compose command.

• MFTP_CONFIG: Absolute path to mftp_config directory
• DOCTOR_CONFIG: Absolute path to doctor_config directory
• MFTP_MODE: Mode of sending mail - --smtp, --gmail-api or --ntfy

sudo MFTP_CONFIG=/path/to/mftp_config DOCTOR_CONFIG=/path/to/doctor_config MFTP_MODE="--smtp" docker-compose up -d # Using SMTP for sending mails

sudo MFTP_CONFIG=/path/to/mftp_config DOCTOR_CONFIG=/path/to/doctor_config MFTP_MODE="--gmail-api" docker-compose up -d # Using Gmail API for sending mails

sudo MFTP_CONFIG=/path/to/mftp_config DOCTOR_CONFIG=/path/to/doctor_config MFTP_MODE="--ntfy" docker-compose up -d # Using NTFY for serving notifications

It is also possible to run these docker containers as a cronjob:

• Comment out the line restart: unless-stopped in docker-compose.yml
• Append --cron into the MFTP_MODE env variable and set DOCTOR_MODE to --cron as well. As follows:
  • Using Cronjob to run containers and SMTP to send mails

    sudo MFTP_CONFIG=/path/to/mftp_config DOCTOR_CONFIG=/path/to/doctor_config MFTP_MODE="--smtp --cron" DOCTOR_MODE="--cron" docker-compose up -d

  • Using Cronjob to run containers and Gmail API to send mails

    sudo MFTP_CONFIG=/path/to/mftp_config DOCTOR_CONFIG=/path/to/doctor_config MFTP_MODE="--gmail-api --cron" DOCTOR_MODE="--cron" docker-compose up -d

  • Using Cronjob to run containers and NTFY to serve notifications

    sudo MFTP_CONFIG=/path/to/mftp_config DOCTOR_CONFIG=/path/to/doctor_config MFTP_MODE="--ntfy --cron" DOCTOR_MODE="--cron" docker-compose up -d

• Add the updated command with desired cron expression into your cronjob using crontab -e

(back to top)

To set up a local instance of the application without using docker, follow the steps below.

1. Shells
   • bash
   • zsh
2. OS(s)
   • any *nix[GNU+Linux and Unix]

(back to top)

The following requirements are to be satisfied for the project to function properly:

• For mftp
• For mftp doctor

(back to top)

Now that the environment has been set up and configured to properly compile and run the project, the next step is to download and configure the project locally on your system.

1. Clone the repository

   git clone https://github.com/metakgp/mftp
   cd mftp

2. Install required dependencies

   pip3 install -r requirements.txt

3. Follow the installation steps for mftp
4. Follow the installation steps for mftp doctor

5. Configure the mftp service

   For linux systems, MFTP & MFTP Doctor are available as a service and as cronjob. To configure them, execute the following commands after navigating into the root directory of the project (inside the mftp folder).

   cd service/
   ./configure-service.sh

(back to top)

After configuring MFTP as a service, you can use the mftp command with several options to interact with the tool as a service.
Following is the help menu for the service.

Usage: mftp [COMMAND] [OPTIONS]

Command:
  -h, --help                   Display this help and exit
  logs [OPTIONS]               Display last 25 lines of mftp log file
    Options:
      clear                    Clear the mftp log file
      NUM                      Display last NUM lines of mftp log file
  disable                      Disable mftp service
  enable                       Enable mftp service
  status                       Check status of mftp service
  restart                      Restart mftp service
  stop                         Stop mftp service
  start                        Start mftp service

  cronjob [OPTIONS]            Use mftp as a cronjob
    Options:
      enable [NUM]             Enable mftp cronjob after every NUM minutes (default is 2 minutes)
      disable                  Disable mftp cronjob
      status                   Check status of mftp cronjob

  doctor [OPTIONS]             Use mftp doctor as a cronjob
    Options:
      enable [NUM]             Enable doctor cronjob after every NUM minutes (default is 2 minutes)
      disable                  Disable doctor cronjob
      status                   Check status of doctor cronjob
      logs [OPTIONS]           Display last 25 lines of doctor log file
        Options:
          clear                Clear the doctor log file
          NUM                  Display last NUM lines of doctor log file

(back to top)

• Arpit Bhardwaj

(back to top)

📫 Metakgp -

(back to top)

• License
• Code of Conduct
• Security Policy
• Contribution Guidelines

(back to top)