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

# moorcheh status

> Check server health and global item quota.

## Overview

Calls `GET /health` and prints a one-line quota summary, then the full health JSON.

Use after `moorcheh up` to confirm the API is reachable and see how much of the global item cap is in use.

## Synopsis

```bash theme={null}
moorcheh status [--base-url URL]
```

## Options

| Flag         | Default                 | Description           |
| ------------ | ----------------------- | --------------------- |
| `--base-url` | `http://localhost:8080` | Moorcheh API base URL |

## Examples

```bash theme={null}
moorcheh status

moorcheh status --base-url http://localhost:8081
```

## Output

**Line 1** — human-readable summary:

```
items: 4 / 100000  |  remaining: 99996  |  model: nomic-embed-text
```

**Line 2+** — JSON from `/health`:

<ResponseField name="status" type="string">
  `"ok"` when the server is healthy.
</ResponseField>

<ResponseField name="model" type="string">
  Ollama embedding model configured on the server.
</ResponseField>

<ResponseField name="items" type="number">
  Total items stored across all namespaces.
</ResponseField>

<ResponseField name="max_items" type="number">
  Global item cap (default `100000`).
</ResponseField>

<ResponseField name="remaining" type="number">
  `max_items - items`.
</ResponseField>

```json Example JSON theme={null}
{
  "items": 4,
  "max_items": 100000,
  "model": "nomic-embed-text",
  "remaining": 99996,
  "status": "ok"
}
```

<Note>
  JSON key order may vary. All fields above are present on success.
</Note>

## Exit codes

| Code | Meaning                                                             |
| ---- | ------------------------------------------------------------------- |
| `0`  | Server is up and returned health                                    |
| `1`  | Connection refused or API error (for example after `moorcheh down`) |

## Related

* [API: Health](/on-prem/api-references/health)
* [Python: health()](/on-prem/python-client/health)
* [moorcheh up](/on-prem/cli/runtime/up)