On GitHub, Kong/insomnia-mockbin has picked up 2.0k stars, JavaScript. Insomnia Mockbin is the underlying backend for the API mocks capability of Insomnia. It is built and used by Kong, the author of the open-source Kong Gateway.
Snapshot summary built from the project's own GitHub metadata — there's no written TopGit review yet. The page will update automatically when a full review is published.
WHY NO REVIEW YET
TopGit writes full reviews for the most-starred, most-requested repositories. This page is a snapshot until then — see the READ ME tab for the original README in full.
Note: This repository is source visibile, but not open-source. Please check the LICENSE before using this software.
Insomnia Mockbin is maintained by Kong, who also maintains the open-source API Gateway Kong and Insomnia.
Table of contents
Insomnia Mockbin
Table of contents
Features
Installation
Requirements
Running with Node
Running with Docker Compose
Documentation
API Docs
Releasing
Software Bill of materials
Verify a container image signature
Verify a container image provenance
Bugs and feature requests
Contributing
License
Features
uses HAR format
supports JSON, YAML, XML, HTML output
plays nice with proxies (uses the X-Forwarded-* headers for IP resolution)
allows for HTTP Method Override using the header X-HTTP-Method-Override or through query string parameter: _method
create custom bins for experimenting log collection
Local Development
Requirements
Redis
brew install redis
brew services start redis
Redis should be now running on localhost:6379
Mockbin will start without redis but you wont be able to set or get response bins.
git clone https://github.com/Kong/mockbin.git ./mockbin
cd mockbin
cp .env.sample .env
brew install fnm
fnm use
npm install
Note: nvm, n or volta can be used instead of fnm.
Running with Node
npm start
# OR watch for changes
npm run dev
# OR with debug logs
DEBUG=mockbin npm run dev
Running with Docker Compose
docker compose up
Releasing
Run the following command and push the newly created commit into your PR.
This will bump commit and tag, you will need to push this to the remote, which trigger the release action upon merging the PR.
npm version patch
git push origin tag <tag_name>
Documentation
API Docs
Read the full API documentation, please review the API Docs.
Deployment
See https://developer.konghq.com/insomnia/mock-servers/ for the available options for deploying mockbin.
Software Bill of materials
Kong Insomnia Mockbin produces SBOMs for the below categories:
For docker container images
For source code repository
The SBOMs are available to download at:
Github Release / Tag Assets
Github workflow assets for other workflow runs
Verify a container image signature
Docker container images are now signed using cosign with signatures published to a Github Container registry with insomnia-mockbin repository. Separate images are published for cloud hosted mocks (ghcr.io/kong/insomnia-mockbin-cloud) and self-hosted mocks (ghcr.io/kong/insomnia-mockbin-self-hosted). Modify the examples below if you need to verify the image for self-hosted mocks.
Steps to verify signatures for signed Kong Insomnia Mockbin Docker container images in two different ways:
A minimal example, used to verify an image without leveraging any annotations. For the minimal example, you only need Docker details, a GitHub repo name, and a GitHub workflow filename.
A complete example, leveraging optional annotations for increased trust. For the complete example, you need the same details as the minimal example, as well as any of the optional annotations you wish to verify:
cosign verify \
ghcr.io/kong/insomnia-mockbin-cloud:<tag>@sha256:<digest> \
--certificate-oidc-issuer='https://token.actions.githubusercontent.com' \
--certificate-identity-regexp='https://github.com/Kong/insomnia-mockbin/.github/workflows/release.yaml' \
-a repo='Kong/insomnia-mockbin' \
-a workflow='Package & Release'
Verify a container image provenance
Kong Insomnia Mockbin produces build provenance for docker container images for Github tags, which can be verified using cosign / slsa-verifier with attestations published to a Github Container registry with insomnia-mockbin repository.
Steps to verify provenance for signed Kong Insomnia Mockbin Docker container images:
A minimal example, used to verify an image without leveraging any annotations. For the minimal example, you only need Docker Image manifest, a GitHub repo name.
A complete example, leveraging optional annotations for increased trust. For the complete example, you need the same details as the minimal example, as well as any of the optional annotations you wish to verify:
Have a bug or a feature request? Please first read the issue guidelines and search for existing and closed issues. If your problem or idea is not addressed yet, please open a new issue.
Contributing
Please read through our contributing guidelines. Included are directions for opening issues, coding standards, and notes on development.
More over, if your pull request contains JavaScript patches or features, you must include relevant unit tests.
Editor preferences are available in the editor config for easy use in common text editors. Read more and download plugins at http://editorconfig.org.
How active is development on Kong/insomnia-mockbin?
The most recent commit recorded on Kong/insomnia-mockbin was 25 days ago, based on the GitHub push timestamp. The repository has 211 forks — one of the better signals of community interest.
How many stars does Kong/insomnia-mockbin have?
Kong/insomnia-mockbin has 2.0k GitHub stars — refresh the page for the live number, or check github.com/Kong/insomnia-mockbin. TopGit mirrors GitHub's count but does not claim minute-by-minute accuracy.
Is Kong/insomnia-mockbin open source?
TopGit's metadata for Kong/insomnia-mockbin does not record a license. Most public repositories on GitHub ARE open source, but the exact terms vary — verify by opening the LICENSE file directly.
What is Kong/insomnia-mockbin?
Kong/insomnia-mockbin (Kong/insomnia-mockbin) is a JavaScript project on GitHub. From the project's own README: Insomnia Mockbin is the underlying backend for the API mocks capability of Insomnia. It is built and used by Kong, the author of the open-source Kong Gateway.
Where do I read more about Kong/insomnia-mockbin?
This TopGit page is a snapshot — the READ ME tab shows the project's own README content (links stripped, images preserved). The GitHub repository at github.com/Kong/insomnia-mockbin is the definitive source.
Read full README in the tab above.
Still deciding about insomnia-mockbin?
One click hands the question to an AI along with this page — see what it says about insomnia-mockbin.
/insomnia-mockbin
