# Overcast

> Overcast is a free, MIT-licensed local emulator for AWS APIs. Develop and test against AWS-compatible services on your laptop and in CI, with no internet connection, no cloud account, and no bill.

It emulates 50 services behind one endpoint on port 4566, and ships a web console on 4567 that shows what your app created. The current release is v0.0.1-alpha.42. Coverage is per operation and the project is alpha — the support matrix below has the detail.

Run it:

```bash
docker run --rm \
  -p 4566:4566 \
  -p 4567:4567 \
  ghcr.io/overcast-sh/overcast:latest
```

Then talk to it with any AWS client:

```bash
aws --endpoint-url http://localhost:4566 \
  s3 mb s3://hello-overcast
```

## Where to go next

- [Documentation](https://overcast.sh/docs/index.md): guides and reference.
- [Support matrix](https://overcast.sh/support/index.md): what each service implements.
- [Downloads](https://overcast.sh/downloads/index.md): images, binaries and install commands.
- [llms.txt](https://overcast.sh/llms.txt): the index into all of the above, for agents.