Skip to main content

App Deployment

An App Deployment is the job that actually sends software to machines. You pick what to deploy (a single package or a bundle), choose Install, Uninstall, or Upgrade, target a scope of endpoints, and publish. The list then tracks how many endpoints succeeded, failed, or are still pending.

How to get here

You need View Software permission.

  1. In the left sidebar, click Automation → Software Automation.
  2. Open the App Deployment tab.

Navigate to: Automation → Software Automation → App Deployment

URL path: /automation/software-automation/deployments

The App Deployment screen

The App Deployment list with stage and progress countsThe App Deployment list with stage and progress counts

The list refreshes itself periodically so progress stays current.

ColumnWhat it shows
ID / NameThe deployment (a link to open it).
TypeInstall / Uninstall / Upgrade.
StageDraft, Initiated, In Progress, Paused, Failed, Cancelled, or Completed.
PendingEndpoints not started yet (pending / total).
SucceededEndpoints that succeeded (success / total).
FailedEndpoints that failed (failed / total).
Created By / Created OnWho created it and when.

Row actions: View Task (the eye icon, on published deployments) opens the per-endpoint task list; Edit / Delete are available while a deployment is still a draft.

How do I create a deployment?

Click Create. The deployment form opens in a drawer.

The Create App Deployment formThe Create App Deployment form
FieldRequiredNotes
Deployment NameYesA name for the job.
DescriptionYesWhat it does.
Deployment TypeYesInstall, Uninstall, or Upgrade.
Resource TypeYesApplication (a single package) or Application Bundle.
ScopeYesWhich endpoints to target.
Select Application / Application BundleYesThe package or bundle to deploy.
Deployment PolicyYesThe schedule/window rules for the rollout.
Retry CountYesHow many times to retry a failed endpoint.
Notify toYesWho to email about the result.

Finish with Publish to start the deployment now, or Save As Draft to keep editing it later.

Uninstall and Upgrade change software fleet-wide

Uninstall removes the selected app from every endpoint in Scope, and Upgrade replaces it- both run as soon as you Publish, with no automatic rollback if something breaks. Target a small Scope first and confirm before a fleet-wide run.

Drill-down: per-endpoint tasks

Click View Task on a published deployment to open the Tasks drawer.

The per-endpoint deployment tasks drawerThe per-endpoint deployment tasks drawer

It lists every targeted endpoint with its task Status (Waiting, Initiated, In Progress, Failed, Cancelled, Success, Reboot Required), filterable by status. For a completed deployment you can Retry failed or cancelled endpoints.

Click a task name (clickable once it reaches a terminal status) to open its output log- the full step-by-step execution output for that endpoint.

The task output log for one endpoint, showing the step-by-step execution outputThe task output log for one endpoint, showing the step-by-step execution output

Tips & troubleshooting

  • I can't edit a deployment. Only draft deployments are editable. Once published, create a new deployment instead.
  • Some endpoints stay pending. They may be offline or outside the deployment policy's window- they pick the job up when they next check in.