How to Manage Workers in App Platform

Background workers can consist of any application code you like. As far as App Platform is concerned, they are the same as services, except they are not “routable,” i.e. they are not accessible via an external URL.

Create Workers

  1. Go to, click on your app, and click on the Components tab. Add a Worker component by clicking the Create Component button and choosing the Worker option.
Component screen
  1. Select the source code for the Worker on GitHub. If connecting for the first time, you will see an empty repository list and will need to click the link labeled Configure your GitHub permissions, then refresh this page.

  2. Next, give the Worker a name and select which branch of the source repo you’d like to use as the source of the Worker. Click Next.

  3. App Platform will inspect the code and select an appropriate runtime environment (such as Node, Ruby, etc). If you need to override this, you can see if there is a better options in the drop-down labeled Type as well. If nothing suitable appears there, upload a Dockerfile to your branch and restart the app creation process.

  4. App Platform will also display any appropriate build and run commands that it detected, which you can now customize as needed.

  5. If the use of environment variables is required, click Edit and supply them. Click the Encrypt checkbox to ensure a variable’s value is obscured in all build, deploy, and application logs.

  6. Select a plan, and click Launch Worker.

Edit Workers

Go to, click on your app, and click on the Components tab. Click the Worker you’d like to edit.

You can use the configuration settings you see here to change the Worker’s scaling behavior, modify environment variables, edit commands, and more.

Destroy Workers

Go to, click on your app, and click on the Components tab. Click on the Worker you’d like to destroy.

You can destroy the Worker by clicking the Destroy Component button on the bottom of the page and entering its name to confirm your selection.

The build and run commands are the command-line statements that compile your app component at build time and launch your app component after it has been built, respectively.
A component in App Platform is any deployable, billable, run-time software element in your app. A component can be a database, a service, a worker, or a static site.
A container is a single running instance of a service, worker, or static site component shipped on App Platform.
In App Platform, a worker is a type of component that is not internet accessible but runs server-side code written in a supported programming language, such as Python, Ruby, Go, Node.js, or PHP.