Common Issues

Task Creation & Execution

Task is stuck on Waiting for a Sandbox to be Available

This status means that you've hit a soft limit on the number of new sandboxes that can be created per user per hour. Terragon will start your new tasks as soon as the limit resets, typically within 5-10 minutes.

Environment Variables are not working

Changes to environment variables are only available for tasks created after the changes are made. Double-check for typos in variable names and trailing spaces, then confirm the variables are saved.

GitHub Integration

Can't See My GitHub Repositories

• Confirm which repositories you've granted access to in Settings
• Ensure you're logged in with the correct GitHub account

GitHub PRs are not being created

• Check for branch protection rules that may be preventing Terragon from pushing to the branch
• Confirm you have push access to the repository

GitHub @-mentions are not working

• Confirm the GitHub App is installed on the repository
• Confirm you have a Terragon account with the same GitHub email
• Ensure you're mentioning @terragon exactly
• Confirm you're tagging @terragon in a repository you've granted access to in Settings