Upsun User Documentation

Configure workers

Try Upsun for 15 days
After that, enjoy the same, game-changing Upsun features for less with the First Project Incentive!ยน A monthly $19 perk!
ยนTerms and conditions apply
Activate your 15-day trial

Workers (or consumers) are a great way to off-load processing in the background to make an app as fast as possible. You can implement workers in Symfony smoothly thanks to the Messenger component.

To deploy a worker, add an entry under the workers section in your app configuration:

.upsun/config.yaml
applications:
  myapp:
    workers:
      mails:
        commands:
          start: symfony console messenger:consume --time-limit=60 --memory-limit=128M

Note that the symfony binary is available when you use the Symfony integration in your Upsun app configuration.

On Upsun, worker containers run the exact same code as the web container. The container image is built only once and deployed multiple times in its own container alongside the web container. The build hook and dependencies might not vary but, as these containers are independent, they can be customized the same way using common properties. The values defined for the main container are used as default values.

The commands.start key is required. It specifies the command you can use to launch the application worker. If the command specified by the start key terminates, it’s restarted automatically.

For more information, see Workers.

Is this page helpful?