# Microcks

Microcks is an open-source, cloud-native API mocking and testing platform for developers and platform teams that turns API specifications and microservice assets into live mocks and runs contract conformance and. It is open source and self-hosted, installable on Docker Hub and Kubernetes (Helm).

Canonical page: https://ourlocalhost.com/app/4811/microcks

## Description

Microcks is an open-source, cloud-native API mocking and testing platform for developers and platform teams that turns API specifications and microservice assets into live mocks and runs contract conformance and non-regression tests to validate integration early.

## Platform availability

Available on 1 of 10 platforms: Helm.

## Health score

62/100 (Good), based on 4 of 5 factors.
- Maintained: 100 (last commit 8 days ago)
- Popular: 66 (2,089 GitHub stars)
- Easy to install: 25 (1 install platform, install notes)
- Security check: 20 (1 serious finding, 2 minor, CI, tests, OpenSSF Scorecard 7.1/10)

## Security check

1 serious finding: A private key is committed in the source code.
Automated checks on commit 0e0c0b4, 23 Oct 2026. Not an audit.

## Links

- GitHub: https://github.com/microcks/microcks
- Docker Hub: https://hub.docker.com/r/microcks/microcks
- Kubernetes (Helm): https://artifacthub.io/packages/helm/microcks/microcks
- Official website: https://microcks.io

## Common questions

### Which Helm settings need to match my exposed address in a Kubernetes install?

Set microcks.url and keycloak.url to the address that people and services will actually use. If these values are wrong, login redirects and saved API calls can break.

### What do I need to know about Keycloak before the first login?

Keycloak is the login service in front of Microcks, so create or verify a user before signing in. The admin username and password are in the Helm notes or the microcks-keycloak-admin secret.

### Why might gRPC calls to a Kubernetes-deployed mock fail?

If you will test gRPC services, copy the gRPC TLS certificate shown in the Helm notes into your gRPC client's trusted certificates. Without it, the client may not trust the server and calls can fail.

### Why does importing an API artifact report no service found or an empty result?

Check that the artifact follows the expected conventions for its API type. You should also confirm that examples are defined, because Microcks relies on them.

---
Source: Our Local Host (https://ourlocalhost.com/app/4811/microcks), the self-hosted and open-source app directory.
