Ona Environment Fails: AWS account policy blocks ssm:SendCommand

Share
Workaround available AWS Updated November 14, 2026How we research

Quick answer

The runner needs ssm:SendCommand and ssm:GetCommandInvocation. Update the runner stack and have your AWS admin check for an SCP deny, which an IAM allow cannot override.

Most likely fix: Update permissions

How to fix it

Try these in order — the most common fix is first.

  1. 1. Update permissions

    1. Update the runner CloudFormation stack to apply the current IAM policy
    2. Ask your AWS administrator to check SCPs
    3. Use Resource * for ssm:GetCommandInvocation; ssm:SendCommand can stay scoped to environment instances and the AWS-RunShellScript document
    Did this fix it?

Symptoms

Environments fail with AWS account policy blocks ssm:SendCommand, the runner is marked degraded, or startup is slow.

Why it happens

  • Service Control Policy denies SSM actions
  • Runner IAM policy is outdated

This guide also covers

  • ssm:sendcommand gitpod
  • ona runner degraded
  • ona environment fails to start

Still not working?

If Gitpod keeps failing, you're not alone. See every Gitpod problem users report or the alternatives people switch to.

Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.

Talk to us
Fixed it? Share this guide

The same problem in other apps

All plan limits, paywalls & watermarks guides →

Other Gitpod errors

All 10 Gitpod errors and fixes →