Edge Stacks

Edge Stacks is a feature that lets you deploy multiple applications to multiple environments from a single page and multiple sources, regardless of their current state.

This functionality requires you to enable Edge Compute features.

The Edge Stacks page displays a list of Edge Stacks deployed across your environments and devices and includes their name, the status of the deployment across the relevant environments (acknowledged, images pre-pulled, deployed and failed), the total deployment count, and the creation date.

You can click on an individual stack's name to edit the stack:

You can also view details about the stack's deployment across environments on the Environments tab, as well as retrieve, download, and clear retrieved log files from the respective environments.

Add a new stack

From the menu select Edge Stacks then click Add stack.

Give the stack a descriptive name then select one or more Edge Groups.

In Deployment type, select the type of deployment you are performing.

This may be auto-selected by your choice of Edge Groups.

In the Build Method, define how to deploy your app from one of the following options:

Option	Overview
Web editor	Use the Portainer web editor to write or paste in your build file.
Upload	Upload a build file from your computer.
Repository	Use a GitHub repo where the build file is stored.
Template	Use an Edge stack template. Only available for the Compose deployment type.

You can search within the web editor at any time by pressing Ctrl-F (or Cmd-F on Mac).

If your stack requires access to images in private registries, you can specify which registry to use as part of the deployment.

Pre-pull images

By default, Docker will start containers within the stack that it already has images for, while at the same time pulling any other images it needs from the upstream registries. In some cases you may want to wait until all of the needed images are pulled to the device before starting the stack. To do this, enable the Pre-pull images toggle. This can also help to avoid issues when some images in a stack are unable to be pulled, leading to an incomplete or partial deployment.

Retry deployment

If a deployment of an Edge Stack fails (for example if the remote Edge environment is unavailable), by default Portainer will not try and redeploy the stack. If you wish to enable retrying of failed deployments, you can toggle Retry deployment to on.

When Retry deployment is enabled for an Edge Stack and the deployment of the Edge Stack fails, Portainer will:

1. Retry the deployment every 10 seconds for the first hour.

2. After the first hour, retry once an hour for 7 days.

3. After 7 days, Portainer will stop retrying and the Edge Stack will be given a "failed" status.

Once the configuration is completed, click Deploy stack.