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

# Troubleshooting

[简体中文](/v2/zh/service/troubleshooting)

Start with the affected work record. Record the version, time and Session, Task, Attempt or Run IDs, then inspect the relevant component. Remove tokens, passwords and sensitive business data before sharing logs.

| Symptom                          | Check first                                                                        |
| -------------------------------- | ---------------------------------------------------------------------------------- |
| Image pull fails                 | Release manifest namespace, tag, authentication and architecture                   |
| Container is unhealthy           | `docker compose ps`, database readiness and component logs                         |
| Helm Pod stays Pending           | Bound PVCs and StorageClass access-mode support                                    |
| Login fails                      | Bootstrap versus existing password; whether the database already contains accounts |
| Local Environment rejected       | Explicit Local opt-in, or use Sandbox / Self-hosted                                |
| Agent does not respond           | Model credentials, Environment binding, tool confirmations and Dataplane logs      |
| Team remains waiting             | Unfinished member tasks, missing input, approvals or deliverable review            |
| History disappears after restart | Accidental memory storage, changed database or volumes                             |
| OAuth callback fails             | Public origin, platform callback URL and HTTPS reachability                        |
| Runtime Host offline             | Installed provider, credentials, network and daemon logs                           |
| SDK gRPC connection fails        | Kubernetes-native ASDP availability and correct gRPC port                          |

## Collect component logs

```bash theme={null}
docker compose logs --tail=200 control data scheduler gateway
kubectl -n agentscope logs deployment/service-agentscope-control --tail=200
kubectl -n agentscope describe pod POD_NAME
```

Gateway health does not verify model or tool execution. Inspect Dataplane for Managed Session failures, Scheduler for channel/Worker scheduling, and Control for product Automations, resources, accounts and orchestration. Hosted provider failures also need the machine's daemon logs.

## Restarting did not reset the administrator password

This is expected. `AISTIO_BOOTSTRAP_PASSWORD` applies only to an empty account table. Change existing passwords through Profile or administrator account management rather than regenerating `.env`.

## Vault decryption fails

Check that recovery preserved the original `BUILDER_VAULT_MASTER_KEY` and that all components use the same value. Restore matching configuration and data before trying to replace keys.

## Work arrived but no final result

Inspect the Run, Node and latest Attempt from Issue Executions, not just the last message. Check dependencies, approvals or signals for waiting, missing input for blocked, and errors/partial artifacts for failed. Inbox Request changes does not start execution. Verify task reporting for External adapters and provider exit/reporting for Hosted work.

## Repeated Webhook or Endpoint requests

Query the existing Delivery/Invocation first. Reuse the same key and content for the same logical request; assign a new key only to new work. Check trigger event filters, authentication and schemas. After SSE disconnects, query the returned statusUrl before resubmitting.