Skip to main content

​
FAQ

​
Q1: Why does cluster startup fail?

Run environment diagnostics first and verify runtime prerequisites. 
aios doctor
aios infra cluster status

​
Q2: Why is an agent run stuck?

Check run status and logs before retrying. 
aios agent run list --limit 20
aios agent run get <run-id>
aios agent run logs <run-id>

​
Q3: How to troubleshoot across CLI and UI?

Export logs from CLI and correlate timelines in UI. 
aios infra app logs <app-name> --since 30m > app.log

​
Q4: How to add a new AI tool?

Register credentials and verify connectivity. 
aios agent tool add <tool-name> --token <token>
aios agent tool test <tool-name>

​
Q5: How to manage credentials securely?

  • inject credentials through environment variables or a secrets manager
  • never commit tokens into source control
  • rotate privileged credentials regularly