---
title: Troubleshooting
description: Resources for diagnosing and resolving issues with Pulumi programs and deployments.
url: /docs/iac/operations/troubleshooting/
---


# Troubleshooting Guide

Resources for diagnosing and resolving issues with Pulumi programs and deployments.


## Common issues

- [Update Conflicts](/docs/iac/operations/troubleshooting/update-conflicts/) — Resolve "409 conflict: Another update is currently in progress" errors.
- [Server Errors](/docs/iac/operations/troubleshooting/server-errors/) — Handle 500 internal server errors from Pulumi Cloud.
- [Post-step Errors](/docs/iac/operations/troubleshooting/post-step-errors/) — Troubleshoot post-step event failures and engine bugs.
- [Connection Issues](/docs/iac/operations/troubleshooting/connection-issues/) — Fix network connectivity and proxy problems.
- [DIY Backend Access Errors](/docs/iac/operations/stack-management/using-a-diy-backend/#error-reading-pulumimetayaml) — Resolve `read ".pulumi/meta.yaml"` errors when the CLI can't access a self-managed state backend.
- [Destroy Failures](/docs/iac/operations/troubleshooting/destroy-failures/) — Handle scenarios when `pulumi destroy` fails.
- [Interrupted Updates](/docs/iac/operations/troubleshooting/interrupted-updates/) — Recover from interrupted deployments.
- [macOS Architecture Mismatch](/docs/iac/operations/troubleshooting/architecture-mismatch/) — Fix crashes or hangs on Apple Silicon caused by x86_64 binaries running under Rosetta 2.


## Related

- [CI/CD Troubleshooting](/docs/iac/operations/continuous-delivery/troubleshooting/) — Resolve continuous integration and deployment pipeline issues.
- [Editing State Files](/docs/iac/operations/stack-management/editing-state-files/) — Safe techniques for modifying Pulumi state files when necessary.
- [Targeted Updates](/docs/iac/operations/stack-management/targeted-updates/) — Limit operations to specific resources with `--target` and `--exclude` when a stuck or misbehaving resource is blocking a wider update.
- [Logging](/docs/iac/operations/debugging/logging/) — CLI verbose logging and program logging for debugging and diagnostics.
- [Using Dev Builds](/docs/iac/operations/debugging/using-dev-builds/) — Install pre-release builds to access bug fixes that haven't shipped in a stable release yet.


## Need more help?



## Have questions?

For questions or feedback, reach out on [community Slack](https://slack.pulumi.com), [GitHub](https://github.com/pulumi), or [contact support](/support/).