{"id":21818095,"url":"https://github.com/absmach/supermq","last_synced_at":"2025-08-18T12:39:05.700Z","repository":{"id":307609269,"uuid":"38644318","full_name":"absmach/supermq","owner":"absmach","description":"Event-driven Infrastructure for Modern Cloud","archived":false,"fork":false,"pushed_at":"2025-08-14T14:47:23.000Z","size":149215,"stargazers_count":2522,"open_issues_count":202,"forks_count":672,"subscribers_count":101,"default_branch":"main","last_synced_at":"2025-08-16T09:08:16.135Z","etag":null,"topics":["coap","distributed-systems","edge","edge-computing","golang","iiot","internet-of-things","iot","iot-cloud","iot-gateway","iot-platform","lora","lorawan","lwm2m","message-broker","messaging","mqtt","opc-ua","telecom","web-socket"],"latest_commit_sha":null,"homepage":"https://www.abstractmachines.fr/magistrala.html","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/absmach.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2015-07-06T20:31:50.000Z","updated_at":"2025-08-16T02:50:39.000Z","dependencies_parsed_at":"2025-08-01T07:36:23.505Z","dependency_job_id":"725046e0-5411-4439-b9cd-54060bcfd16a","html_url":"https://github.com/absmach/supermq","commit_stats":null,"previous_names":["absmach/mainflux"],"tags_count":31,"template":false,"template_full_name":null,"purl":"pkg:github/absmach/supermq","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/absmach%2Fsupermq","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/absmach%2Fsupermq/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/absmach%2Fsupermq/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/absmach%2Fsupermq/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/absmach","download_url":"https://codeload.github.com/absmach/supermq/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/absmach%2Fsupermq/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":270702567,"owners_count":24630878,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-16T02:00:11.002Z","response_time":91,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["coap","distributed-systems","edge","edge-computing","golang","iiot","internet-of-things","iot","iot-cloud","iot-gateway","iot-platform","lora","lorawan","lwm2m","message-broker","messaging","mqtt","opc-ua","telecom","web-socket"],"created_at":"2024-11-27T16:00:58.969Z","updated_at":"2025-08-18T12:39:05.691Z","avatar_url":"https://github.com/absmach.png","language":"Go","funding_links":[],"categories":["Projects","Go"],"sub_categories":["Message Broker"],"readme":"\u003cdiv align=\"center\"\u003e\n\n  # SuperMQ\n  \n  **Planetary event-driven infrastructure**\n  \n  **Made with ❤️ by [Abstract Machines](https://abstractmachines.fr/)**\n  \n  [![Build Status](https://github.com/absmach/supermq/actions/workflows/build.yaml/badge.svg?branch=main)](https://github.com/absmach/supermq/actions/workflows/build.yaml)\n  [![Check License Header](https://github.com/absmach/supermq/actions/workflows/check-license.yaml/badge.svg?branch=main)](https://github.com/absmach/supermq/actions/workflows/check-license.yaml)\n  [![Check Generated Files](https://github.com/absmach/supermq/actions/workflows/check-generated-files.yaml/badge.svg?branch=main)](https://github.com/absmach/supermq/actions/workflows/check-generated-files.yaml)\n  [![Go Report Card](https://goreportcard.com/badge/github.com/absmach/supermq)](https://goreportcard.com/report/github.com/absmach/supermq)\n  [![Coverage](https://codecov.io/gh/absmach/supermq/graph/badge.svg?token=nPCEr5nW8S)](https://codecov.io/gh/absmach/supermq)\n  [![License](https://img.shields.io/badge/license-Apache%20v2.0-blue.svg)](LICENSE)\n [![Matrix](https://img.shields.io/matrix/supermq%3Amatrix.org?label=Chat\u0026style=flat\u0026logo=matrix\u0026logoColor=white)](https://matrix.to/#/#supermq:matrix.org)\n  \n  ### [Guide](https://docs.supermq.abstractmachines.fr) | [Contributing](CONTRIBUTING.md) | [Website](https://abstractmachines.fr/) | [Chat](https://matrix.to/#/#supermq:matrix.org)\n\n\u003c/div\u003e\n\n\n\n## Introduction 📖\n\nSuperMQ is a distributed, highly scalable, and secure open-source cloud platform for messaging and event-driven architecture (EDA). It is a planetarily distributed, highly scalable, and secure platform that serves as a robust foundation for building advanced real-time and reactive systems.\n\n## Why SuperMQ Stands Out 🚀\n\nSuperMQ bridges the gap between various network protocols (HTTP, MQTT, WebSocket, CoAP, and more) to provide a seamless messaging experience. Whether you're working on IoT solutions, real-time data pipelines, or event-driven systems, SuperMQ has you covered. 🌐✨\n\n## Key Features 🌟\n\n- **Multi-Protocol Connectivity**: HTTP, MQTT, WebSocket, CoAP, and more! 🌉\n- **Secure by Design**: Mutual TLS (mTLS) with X.509 Certificates, JWT support, and multi-protocol authorization. 🔒\n- **Fine-Grained Access Control**: Support for ABAC and RBAC policies. 📜\n- **Multi-Tenant**: Manage multiple domains seamlessly. 🏢\n- **Multi-User**: Unlimited organizational hierarchies for user management. 👥\n- **Application Management**: Group and share messaging clients for streamlined operations. 📱\n- **Ease of Use**: Simple and powerful communication channel management, grouping, and sharing. ✨\n- **Personal Access Tokens (PATs)**: Scoped and revocable tokens for enhanced security. 🔑\n- **Observability**: Integrated logging and instrumentation with Prometheus and OpenTelemetry. 📈\n- **Event Sourcing**: Build robust and scalable architectures. ⚡\n- **Edge and IoT Ready**: Supports MQTT and CoAP protocols for seamless IoT gateway and sensor communication and management. 🌍\n- **Developer-Friendly**: SDKs, CLI tools, and comprehensive documentation to get you started. 👩‍💻👨‍💻\n- **Production-Ready**: Container-based deployment using Docker and Kubernetes. 🐳☸️\n\n## Installation 🛠️\n\nClone the repository and start SuperMQ services:\n\n```bash\ngit clone https://github.com/absmach/supermq.git\ncd supermq\ndocker compose -f docker/docker-compose.yaml --env-file docker/.env up\n```\n\nOr use the [Makefile](Makefile) for a simpler command:\n\n```bash\nmake run\n```\n\nFor production deployments, check our [Kubernetes guide](https://docs.supermq.abstractmachines.fr/kubernetes). ⚙️\n\n### Usage 📤📥\n\n#### Using the CLI:\n\n```bash\nmake cli\n./build/supermq-cli status\n```\n\nThis command retrieves the status of the SuperMQ server and outputs it to the console.\n\n#### Using HTTP with Curl:\n\n```bash\ncurl -X GET http://localhost:8080/status\n```\n\nThis request fetches the server status over HTTP and provides a JSON response.\n\nSee our [CLI documentation](https://docs.supermq.abstractmachines.fr/cli) for more details.\n\n## Documentation 📚\n\nThe official documentation is hosted at [SuperMQ docs page](https://docs.supermq.abstractmachines.fr).\n\nDocumentation is auto-generated, check out the instructions in the [docs repository](https://github.com/absmach/supermq-docs).\nIf you spot an error or a need for corrections, please let us know - or even better: send us a PR! 💌\n\n## Community and Contributing 🤝\n\nThank you for your interest in SuperMQ and the desire to contribute!\n\n1. Take a look at our [open issues](https://github.com/absmach/supermq/issues). The [good-first-issue](https://github.com/absmach/supermq/labels/good-first-issue) label is specifically for issues that are great for getting started.\n2. Checkout the [contribution guide](CONTRIBUTING.md) to learn more about our style and conventions.\n3. Make your changes compatible to our workflow.\n\nJoin our community:\n\n- [Matrix Room](https://matrix.to/#/#supermq\\:matrix.org)\n\n## Professional Support 💼\n\nNeed help deploying SuperMQ or integrating it into your system? Reach out to **[Abstract Machines](https://abstractmachines.fr/)** for professional support and guidance.\n\n## License 📜\n\nSuperMQ is open-source software licensed under the [Apache License 2.0](LICENSE). Contributions are welcome!\n\n## Acknowledgments 🙌\n\nSpecial thanks to the amazing contributors who make SuperMQ possible. Check out the [MAINTAINERS](MAINTAINERS) file to see the team behind the magic.\n\nReady to build the future of messaging and event-driven systems? Let's get started! 🚀\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabsmach%2Fsupermq","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fabsmach%2Fsupermq","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fabsmach%2Fsupermq/lists"}