# mayastor-api-rest

mayastor-api-rest is a self-hosted infrastructure app. The REST API control-plane service of OpenEBS Mayastor, a cloud-native distributed block storage data plane for Kubernetes. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/5454/mayastor-api-rest

## Description

The REST API control-plane service of OpenEBS Mayastor, a cloud-native distributed block storage data plane for Kubernetes. It exposes the endpoints the OpenEBS stack uses to manage volumes and is normally deployed inside the full Mayastor Helm chart rather than on its own.

## Platform availability

Available on 1 of 10 platforms: Helm.

## Health score

70/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 15 days ago)
- Popular: 61 (1,078 GitHub stars)
- Easy to install: 20 (1 install platform, Docker image)
- Security check: 70 (no serious findings, 10 minor, CI, tests)

## Links

- Docker Hub: https://hub.docker.com/r/openebs/mayastor-api-rest
- GitHub: https://github.com/openebs/mayastor

## Common questions

### Will Mayastor tie up a CPU core when idle?

Users report Mayastor can keep a CPU core pinned at 100% because it uses poll-based drivers, even with no I/O or no PVC created.

### Can a small storage allocation cause Mayastor pods to crash?

Users have reported Mayastor pods crashing after a few days with 'no space left on device' errors in a small storage allocation.

### Which logs should I collect when troubleshooting Mayastor Replicated Storage?

If the problem is unclear, collect log files for all Replicated Storage containers. The docs note that control-plane logs are relevant in nearly every case.

### Does the MicroK8s Mayastor addon work without extra setup?

The addon provides cluster-ready replicated storage, but initial setup and configuration are required.

---
Source: Our Local Host (https://ourlocalhost.com/app/5454/mayastor-api-rest), the self-hosted and open-source app directory.
