Background Task Unleashed consists of 2 separate (but cooperating) open source applications:

  1. BTU : A Frappe web application (link to GitHub repository)
  2. BTU Scheduler : A background daemon that schedules tasks by integrating BTU and Python RQ. (link to GitHub repository)

To use the BTU, you -must- install both applications on the same device that hosts your Frappe web server.


The BTU git branches will stay synchronized with the LTS branches of Frappe Framework. The current support versions are:

Installation #1: BTU (the Frappe App)

The front-end of BTU is a Frappe web application. It is the command & control center for BTU. From your web browser you will:


You install BTU like any other Frappe web application. You use the Bench CLI application to download, install, and assign to your Sites.

From your Frappe web server, in a terminal:

bench get-app --branch version-13
bench --site your_site_name install-app btu

Installation #2: BTU Scheduler (the Linux daemon)

This is the backend application. It is “always on” Linux daemon that you install on your Frappe web server. The Scheduler is responsible for monitoring the Tasks, placing them into Queues at the correct datetime, and performing some light communication with the Frappe web server and Python RQ.

Unlike Frappe Apps, this Scheduler is a 64-bit Linux binary executable. It does not require Python, JS, Frappe, or any 3rd party libraries or dependencies.


1. Download the binary executable file from GitHub.

The latest versions can be found on the ‘Releases’ web page. It’s important to choose the correct release for your Linux distribution:

2. Save the binary file.

You can save anywhere the binary executable anywhere on your server (especially if you’re comfortable creating symlinks). However, I recommend saving btu_scheduler file somewhere on your PATH. A good place is this directory:


So, a complete path to the Scheduler would be: /usr/local/bin/btu-scheduler

3. Test your work

Running the Scheduler

After you download and save, execute by opening a terminal and typing:


The BTU Scheduler keeps running forever, until you force it to stop. When running in a terminal, just enter CTRL+C

How To Start the Scheduler automatically?

While you “could” just keep BTU Scheduler running all the time in a terminal? It was really designed to be run as a background daemon. There are many ways you can accomplish this, but I recommend using systemd and writing a Systemd Unit File.

  1. Use your favorite text editor (vim, nano, micro) to create a new Unit file: /etc/systemd/system/erpnext_rqscheduler.service

Add the following contents:

Description=BTU Scheduler




Next Up: Configuration

Now that you have installed BTU and BTU Scheduler, you must configure them to communicate with each other, and Python RQ.