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

# Health & Readiness

> Unauthenticated health, readiness, and liveness probes for monitoring and orchestration.

## Overview

Memanto exposes three unauthenticated probe endpoints at the server root (not under `/api/v2`), intended for load balancers, container orchestrators, and uptime monitoring. None require a Moorcheh API key or session token.

## Authentication

None. All three endpoints are open.

## `GET /health`

Reports whether the server can reach Moorcheh (cloud API or on-prem server, depending on the active backend).

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "http://localhost:8000/health"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - Healthy theme={null}
  {
    "status": "healthy",
    "service": "MEMANTO",
    "version": "0.2.4",
    "moorcheh_connected": true
  }
  ```

  ```json 200 - Unhealthy (Moorcheh unreachable) theme={null}
  {
    "status": "unhealthy",
    "service": "MEMANTO",
    "version": "0.2.4",
    "moorcheh_connected": false
  }
  ```
</ResponseExample>

<Note>
  `moorcheh_connected: false` does not change the HTTP status code — it still returns `200`. Check the `status` and `moorcheh_connected` fields in the body, not the status code.
</Note>

## `GET /ready`

Kubernetes readiness probe. Always returns `200` once the process has started; use this to gate traffic routing.

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "http://localhost:8000/ready"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - OK theme={null}
  {
    "status": "ready"
  }
  ```
</ResponseExample>

## `GET /live`

Kubernetes liveness probe. Always returns `200` while the process is running; use this to detect a hung process that needs restarting.

<RequestExample>
  ```bash cURL theme={null}
  curl -X GET "http://localhost:8000/live"
  ```
</RequestExample>

<ResponseExample>
  ```json 200 - OK theme={null}
  {
    "status": "alive"
  }
  ```
</ResponseExample>

## Next Steps

* [Kubernetes Deployment](/on-prem/kubernetes) for probe configuration in a K8s manifest
* [Self-Hosting Memanto Server](/on-prem/server-deployment) for Docker/Compose/systemd deployment