The SecureEdge Pro supports running Docker containers to add functionality to your edge gateway, which we call Edge Apps. Regular Docker containers can only be managed locally on the local web interface and require several error-prone manual steps to set up. If they're instead in a Docker Compose project, they can be managed from inside the IXON Cloud. Edge App Management lets you centrally deploy, configure, and remove Edge Apps on all your SecureEdge Pro gateways, making it much easier to manage your Docker containers on your fleet of edge gateways.

For frequently asked questions, see Edge App Management FAQ.

• Prepare an Edge App
• Add an Edge App to an edge gateway
• Deploy, configure, or remove the Edge App
• Upgrade or downgrade the Edge App

Prepare an Edge App

Regular Docker containers cannot be managed with Edge App Management. They first need to be prepared as an Edge App, which is a Docker Compose project.

1. Make sure your edge gateway meets the supported hardware, that you have the required module, and that you have the required role listed at the top of this article.
2. Prepare your Edge App and add it to your IXON Cloud company. For more information, see our developer documentation.

Add an Edge App to an edge gateway

Once you have an Edge App in your IXON Cloud company, you can add it to an edge gateway.

3. Go to Fleet Manager > Devices and click on your device name.
4. In the left menu, go to Edge Apps.
5. Click on Add Edge App, enter the requested information (details below), and click on Confirm.
   

   Field	Description
   App	Select the Edge App you wish to add to this edge gateway. If no Edge App is displayed, you may not have an Edge App in your IXON Cloud company yet. Please start at chapter Prepare an Edge App.
   Version	Select the Edge App version you wish to add to this edge gateway.
   Name	Enter a name for the Edge App on this edge gateway.

Deploy, configure, or remove the Edge App

Once you have added an Edge App to your edge gateway, you can deploy it, updated it, or remove it.

6. Go to Fleet Manager > Devices and click on your device name.
7. In the left menu, go to Edge Apps.
8. Find your Edge App and deploy, configure, or remove it (details below).
   • If the edge gateway is offline, it is not possible to deploy or remove an Edge App.
   • Only one Edge App can be deployed or removed at a time. While an Edge App is being deployed or removed, those actions are disabled for other Edge Apps on this edge gateway.

   Action	Description
   Deploy	This will deploy the Edge App to your edge gateway and run it. If you redeploy an Edge App, it will restore all original files. This means that any local file changes will be reverted (e.g. the flow file in a Node-RED Edge App). Volumes will not be touched. Instead of making local changes, it is recommended to create a new Edge App version and redeploy it on all necessary edge gateways.
   Configure	Enables editing of environment variables and files. Only existing files can be overwritten (max 10 MB per file). New files cannot be added in this manner and should instead be added in a new Edge App version and then redeployed to the edge gateway.
   Remove	This removes the Edge App and its volumes from the edge gateway. Make sure to back up your data before removing the Edge App if wish to retain your data.

   • For more information about your Edge App status, see Edge App status and error info.

Upgrade or downgrade the Edge App

If you have added a new Edge App version and wish to upgrade your Edge App or if something went wrong and you wish to downgrade your Edge App, the steps are exactly the same.

1. Go to Fleet Manager > Devices and click on your device name.
2. In the left menu, go to Edge Apps.
3. Find your Edge App, open More options, and select Upgrade.
4. Select the desired version and click Confirm.
5. Click Deploy.