File size: 1,611 Bytes
6a7089a | 1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 | # Health
Check server status and availability.
## Bridge Mode
```bash
curl http://localhost:9867/health
# CLI Alternative
pinchtab health
# Response
{
"status": "ok",
"tabs": 1
}
```
Notes:
- returns tab count for the attached browser
- in error cases returns `503` with `status: "error"`
## Server Mode (Dashboard)
```bash
curl http://localhost:9867/health
# Response
{
"status": "ok",
"mode": "dashboard",
"version": "0.8.0",
"uptime": 12345,
"profiles": 1,
"instances": 1,
"defaultInstance": {
"id": "inst_abc12345",
"status": "running"
},
"agents": 0,
"restartRequired": false
}
```
| Field | Description |
|-------|-------------|
| `status` | `ok` when server is healthy |
| `mode` | Always `dashboard` in server mode |
| `version` | PinchTab version |
| `uptime` | Milliseconds since server start |
| `profiles` | Number of configured profiles |
| `instances` | Number of running browser instances |
| `defaultInstance` | First managed instance info (if any) |
| `defaultInstance.id` | Instance ID |
| `defaultInstance.status` | `starting`, `running`, `stopping`, `stopped`, `error` |
| `agents` | Number of connected agents |
| `restartRequired` | True if config changes need restart |
| `restartReasons` | List of reasons (when `restartRequired` is true) |
Notes:
- `defaultInstance` is present when at least one instance is running
- use `defaultInstance.status == "running"` to check Chrome is ready
- strategies like `always-on` launch an instance at startup
## Related Pages
- [Tabs](./tabs.md)
- [Navigate](./navigate.md)
- [Strategies](./strategies.md)
|