# Overcast

> Overcast is a free, MIT-licensed local emulator for AWS APIs. Run it with Docker, point supported AWS CLI, CDK, or SDK workflows at http://localhost:4566, and inspect what your app creates in the bundled web console.

Every documentation link below ends in `.md` and returns that page as markdown. The same page renders as HTML at the path without the extension, so https://overcast.sh/docs/storage.md and https://overcast.sh/docs/storage/ hold the same content.

Coverage varies by service and by operation, and these pages describe the current release. The support matrix has the implementation status of every service and operation.

## Site

- [Overcast](https://overcast.sh/index.md): Free and open-source local AWS emulator for development and CI.
- [Documentation](https://overcast.sh/docs/index.md): Start with the quickstart, then route to the guides for building against Overcast, running it…
- [Support matrix](https://overcast.sh/support/index.md): Overcast service and operation implementation status.
- [Downloads](https://overcast.sh/downloads/index.md): Download Overcast Docker images and native binaries.
- [Releases](https://overcast.sh/releases/index.md): Overcast release history and release assets.
- [Web console](https://overcast.sh/console/index.md): The browser UI bundled with Overcast: inbox, event stream, request traces, topology map…
- [Contributing](https://overcast.sh/contributing/index.md): Contribute to Overcast and the Overcast website.

## Overview

- [Overview](https://overcast.sh/docs/overview/index.md): What Overcast emulates and what it deliberately does not, the Docker and native-binary quick starts…

## Getting Started

- [Using AWS CDK with Overcast](https://overcast.sh/docs/cdk/index.md): Bootstrap and deploy a CDK stack against Overcast: the environment CDK needs, the five calls a deploy makes…
- [Install Overcast](https://overcast.sh/docs/install/index.md): One line installs the native binary on macOS, Linux or Windows: what the installer does…
- [The inner loop — live code inside emulated compute](https://overcast.sh/docs/local-dev/index.md): Edit a file and see it take effect without rebuilding an image or redeploying: cdk watch, Lambda hot reload…
- [Migrating from LocalStack](https://overcast.sh/docs/migration-from-localstack/index.md): Swap the image line and keep the rest: the compose diff, the endpoint and hostname settings…
- [Using AWS SDKs and CLI with Overcast](https://overcast.sh/docs/sdk-cli/index.md): Pointing the AWS CLI, Node.js, Python, Go, Java, .NET, Rust and Terraform at Overcast…
- [Testcontainers](https://overcast.sh/docs/testcontainers/index.md): Run Overcast from your integration tests with the Testcontainers module for Go…

## Networking

- [HTTPS and HTTP/2](https://overcast.sh/docs/https/index.md): Two commands for browser-trusted TLS on the API and the web console, what HTTP/2 fixes in the console…
- [Networking and host-based addressing](https://overcast.sh/docs/networking/index.md): One port, one process, and one question: what name does a caller use…

## Storage & Performance

- [Performance and memory](https://overcast.sh/docs/performance/index.md): The startup, memory and image-size targets, what each storage backend costs at startup…
- [Storage and persistence](https://overcast.sh/docs/storage/index.md): Pick and configure a storage backend: what auto resolves to, what survives a restart on each of…

## Troubleshooting

- [Troubleshooting](https://overcast.sh/docs/troubleshooting/index.md): Start here when something is wrong: a symptom-to-guide index, then every startup warning and runtime advisory…

## Reference

- [CLI reference](https://overcast.sh/docs/cli/index.md): The overcast binary: the three commands most people need, and a page per command group — running the daemon…
- [Configuration](https://overcast.sh/docs/configuration/index.md): Overcast is configured entirely with environment variables. The handful most people set…
- [Debug endpoints](https://overcast.sh/docs/debug-endpoints/index.md): The /_overcast/debug/* namespace and always-on diagnostics: health, metrics, state dump, request tracing…
- [LocalStack compatibility matrix](https://overcast.sh/docs/localstack-compatibility/index.md): Every part of a LocalStack setup — ports, endpoints, hostnames, container conventions…
- [Reference index](https://overcast.sh/docs/reference/index.md): Runtime emulation tiers, the full service index with per-service coverage, supported event pipelines…

## More detail

- [Documentation index](https://overcast.sh/docs/llms.txt): Every guide and reference page under /docs/, including the sub-pages this file leaves out.
- [Service reference index](https://overcast.sh/docs/services/llms.txt): Every emulated service, with its operations, limitations and examples.