> ## Documentation Index
> Fetch the complete documentation index at: https://docs.skrmir.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common AiOS troubleshooting paths for startup, deployment, agent execution, and log correlation.

# Troubleshooting

> The repository does not currently ship the `aios ...` troubleshooting commands shown below. They are retained only as direction for a future CLI troubleshooting flow.

## Audience

This page is for developers and operators troubleshooting install, deployment, agent execution, and runtime issues.

## Goal and Scope

This page organizes high-frequency troubleshooting flows across CLI, task state, logs, and UI.

## Common Troubleshooting Paths

### Cluster or platform startup fails

```bash theme={null}
aios doctor
aios infra cluster status
```

### Agent task stalls or produces no output

```bash theme={null}
aios agent run list --limit 20
aios agent run get <run-id>
aios agent run logs <run-id>
```

### CLI and UI correlation

```bash theme={null}
aios infra app logs <app-name> --since 30m > app.log
```

## Pitfalls / Risk Notes

* do not treat audit as just another log stream
* single-instance in-memory state makes troubleshooting far harder

## Related Pages

* [Operations Overview](/en/operations/index)
* [Logging Architecture](/en/operations/logging)
* [Web UI Guide](/en/operations/web-ui-guide)