# modal-devin

> Run secure, resumable Devin Outposts workers on Modal.

## Docs

- [How modal-devin works](https://modal-devin.mintlify.app/explanation/architecture.md): Where Devin Cloud, modal-devin, Modal, and the worker fit together.
- [Resumability](https://modal-devin.mintlify.app/explanation/resumability.md): How suspended sessions preserve work and what happens after a redeploy.
- [Security model](https://modal-devin.mintlify.app/explanation/security.md): Credential boundaries, workload capabilities, and deployment guidance.
- [Session lifecycle](https://modal-devin.mintlify.app/explanation/session-lifecycle.md): What happens when a Devin session starts, suspends, completes, or fails.
- [Timeouts](https://modal-devin.mintlify.app/explanation/timeouts.md): Set session duration without interrupting startup, recovery, or cleanup.
- [Deploy multiple outposts](https://modal-devin.mintlify.app/guides/multiple-outposts.md): Run independent Devin Outposts outposts from one Python project.
- [Operate a deployed worker](https://modal-devin.mintlify.app/guides/operate-a-worker.md): Check health, follow sessions, redeploy changes, and preserve resumability.
- [Configure resources and regions](https://modal-devin.mintlify.app/guides/resources-and-regions.md): Choose compute and placement for Devin session workloads.
- [Configure runtime behavior](https://modal-devin.mintlify.app/guides/runtime-configuration.md): Change polling, session duration, snapshot retention, and logging.
- [Troubleshoot a deployment](https://modal-devin.mintlify.app/guides/troubleshooting.md): Diagnose setup, startup, worker, and resumability problems.
- [Command-line reference](https://modal-devin.mintlify.app/reference/cli.md): Complete reference for modal-devin init, deploy, destroy, doctor, and global options.
- [Exception reference](https://modal-devin.mintlify.app/reference/exceptions.md): Public modal-devin errors and the action to take for each one.
- [Generated application reference](https://modal-devin.mintlify.app/reference/generated-application.md): Supported customization points in the application produced by init.
- [Image helpers reference](https://modal-devin.mintlify.app/reference/images.md): Build the standard workspace and controller images.
- [WorkerSettings reference](https://modal-devin.mintlify.app/reference/settings.md): Runtime policy, environment variables, defaults, and validation.
- [Worker reference](https://modal-devin.mintlify.app/reference/worker.md): Configure one outpost, build its image, and run its Modal entrypoints.
- [Create an outpost](https://modal-devin.mintlify.app/tutorials/create-an-outpost.md): Create a Devin Outposts outpost and deploy its Modal orchestrator.
- [Customize an outpost](https://modal-devin.mintlify.app/tutorials/custom-workspace.md): Customize the project code and tools available to every new Devin session.