Add a Nomad environment

Nomad support in Portainer is provided through the use of the Portainer Edge Agent.

To add a Nomad environment, click on Environments then click the Add environment button.

Select Nomad as your environment type and click Start Wizard. Select the type of Edge Agent you want to deploy: Edge Agent Standard or Edge Agent Async.

The Portainer Edge Agent can be deployed in two different modes - standard mode and async mode. In standard mode, we provide the ability to connect to the remote Edge Agent through a tunnel that is established on-demand from the Edge Agent to the Portainer Server, letting you interact directly with the environment in real time.

In async mode, this tunnel connectivity is not available. Instead, we provide the ability to browse snapshots of the remote environment, allowing you to see the state of the Edge Agent's environment based on a recent state capture sent through to the Portainer Server, as well as use this snapshot to perform actions on the remote environment.

Async mode has been developed to use very small amounts of data and as such is suitable for environments that have limited or intermittent connectivity as well as connections with limited data caps, for example mobile networks.

Enter the environment details using the table below as a guide.

As an optional step you can expand the More settings section and adjust the Poll frequency for the environment (for Edge Agent Standard deployments) - this defines how often this Edge Agent will check the Portainer Server for new jobs. For Edge Agent Async deployments, you can adjust the Ping, Snapshot and Command intervals for the environment - this defines how often this Edge Agent will check in with the Portainer Server for status updates, snapshot updates and to see if there are new pending commands to run, respectively. The default values can be adjusted in the Edge Compute settings.

You can also categorize the environment by adding it to a group or tagging it for better searchability.

When you're ready, click Create. Then complete the new fields that have appeared using the table below as a guide.

Copy the generated command based on your settings and run it on your Nomad environment to deploy the Edge Agent.

If you have set a custom AGENT_SECRET on your Portainer Server instance you must remember to explicitly provide this when deploying your Edge Agent.

If you have another Nomad environment to deploy you can click Add another environment to do so. If you have any other non-Nomad environments to configure click Next to proceed, otherwise click Close to return to the list of environments.