# Suta

> Update, monitor and fix devices in the field as easily as you deploy to the cloud.

Suta deploys containers to fleets of 64-bit Raspberry Pi devices and keeps each change safe: a `suta.yaml` describes what a project's devices run, `suta plan` previews the change, and `suta deploy` rolls it out in stages. Each device checks every change during a probation period and rolls back on its own if it fails.

- Use only the commands, options and `suta.yaml` settings these docs describe.
- Signing in (`suta auth login`) and setting secrets (`suta secret set`) need the person at the keyboard.
- Show the output of `suta plan` and get confirmation before running `suta deploy`.

## Documentation Sets

- [Abridged documentation](https://docs.suta.dev/llms-small.txt): a compact version of the documentation for Suta, with non-essential content removed
- [Complete documentation](https://docs.suta.dev/llms-full.txt): the full documentation for Suta
- [Get started](https://docs.suta.dev/_llms-txt/get-started.txt): What Suta is, the quickstart, a first deploy and the key concepts
- [Add devices](https://docs.suta.dev/_llms-txt/add-devices.txt): Requirements, setting up a new or existing Raspberry Pi, repairing its network and removing it
- [Deploy software](https://docs.suta.dev/_llms-txt/deploy-software.txt): Every suta.yaml setting, staged rollouts, device software and moving to Suta OS
- [Operate devices](https://docs.suta.dev/_llms-txt/operate-devices.txt): The dashboard, monitoring and remote access
- [Your team](https://docs.suta.dev/_llms-txt/your-team.txt): People and roles, alerts and the activity log
- [AI agents and CI](https://docs.suta.dev/_llms-txt/ai-agents-and-ci.txt): Connecting MCP clients, approving their access, API tokens for CI and the GitHub Action
- [Reference](https://docs.suta.dev/_llms-txt/reference.txt): The CLI, the device CLI, permissions, webhooks, limits and troubleshooting

## Notes

- The complete documentation includes all content from the official documentation
- The content is automatically generated from the same source as the official documentation

## Optional

- [suta.yaml JSON Schema](https://suta.dev/schema/suta.json): Every suta.yaml setting, for validating a file
- [MCP agent guide](https://app.suta.dev/mcp/agent-guide.md): How an AI agent connected to Suta's MCP server should work with devices