# Gravitee APIM (optional)

This folder is used by the optional Gravitee APIM stack defined in `docker-compose.gravitee.yml`.
The services will create their own data directories under `gravitee/` when started.

## Start Gravitee with Magent

Run Magent and Gravitee together:

```bash
docker compose -f docker-compose.yml -f docker-compose.gravitee.yml up -d
```

Gravitee services:

- Gateway: http://localhost:8082
- Management API: http://localhost:8083
- Management UI: http://localhost:8084
- Developer portal: http://localhost:8085

Default credentials for the Management UI are typically `admin / admin` on first boot.
Change the password on first login.

## Create a Magent API in Gravitee

1) Open the Management UI at http://localhost:8084.
2) Create a new API (v4 or v2).
3) Set the backend endpoint to `http://magent:8000`.
4) Add a path mapping for `/api` if you want the gateway to front the Magent API.
5) Deploy the API.

Once deployed, route requests through `http://localhost:8082`.