Create Your Engine in PolySwarm UI

All Engine management takes place in the PolySwarm UI at https://polyswarm.network.

As an Engine creator, you need to register a Webhook in your PolySwarm account before creating an Engine in your PolySwarm account. Follow the Webhooks instructions to create a webhook in your PolySwarm account. If you installed ngrok in the previous step, go ahead and start running it now, so you can use the url in the webhook.

After creating your webhook make sure to copy your Webhook Secret. It is used to validate webhook messages received from PolySwarm. Put the Webhook Secret into the Engine's docker/docker-compose.yaml under the microengine-webhooks service. It will look similar to the following:

services:
  microengine-webhooks:
    environment:
      - WEBHOOK_SECRET=YOUR_WEBHOOK_SECRET

Now, run your webserver. So, back in our trusty Terminal, run docker-compose as follows:

(psvenv) $ docker-compose -f docker/docker-compose.yaml up --no-deps microengine-webhooks

Once the webserver is up and running, run a webhook test from the PolySwarm UI. If all goes well, your Webhook will be validated in a few moments.

Armed with a verified Webhook we can now create an Engine. Follow the instructions for Creating an Engine to create an Engine in your PolySwarm account.

It is important to remember that the configuration of your Engine in the PolySwarm UI controls which artifacts your Engine will be tasked to process. Those settings are your mechanism to filter the types of bounties that your Engine will receive.

Next Steps

With your Engine created in the PolySwarm UI, you can use Development Mode to perform live testing in your own personal Development Community.