{"id":20520278,"url":"https://github.com/bashclub/check_mk_matrix_notifications","last_synced_at":"2025-07-22T13:34:42.929Z","repository":{"id":116153888,"uuid":"368852648","full_name":"bashclub/check_mk_matrix_notifications","owner":"bashclub","description":"A Fork of 'check_mk_matrix_notifications' from Stanislav N. aka pztrn (https://gitlab.com/pztrn/check_mk_matrix_notifications) sends checkmk notifications to a matrix chat server.","archived":false,"fork":false,"pushed_at":"2021-05-25T19:50:44.000Z","size":360,"stargazers_count":9,"open_issues_count":1,"forks_count":4,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-04-14T02:13:55.737Z","etag":null,"topics":["checkmk","checkmk-extension","matrix","matrix-org","monitoring","notification-service","omd","synapse"],"latest_commit_sha":null,"homepage":"https://sysops.tv","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/bashclub.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-05-19T11:56:19.000Z","updated_at":"2025-04-09T17:08:15.000Z","dependencies_parsed_at":null,"dependency_job_id":"93186a96-b688-4db3-b86f-adfd451eed85","html_url":"https://github.com/bashclub/check_mk_matrix_notifications","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/bashclub/check_mk_matrix_notifications","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bashclub%2Fcheck_mk_matrix_notifications","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bashclub%2Fcheck_mk_matrix_notifications/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bashclub%2Fcheck_mk_matrix_notifications/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bashclub%2Fcheck_mk_matrix_notifications/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/bashclub","download_url":"https://codeload.github.com/bashclub/check_mk_matrix_notifications/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/bashclub%2Fcheck_mk_matrix_notifications/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":266506208,"owners_count":23940019,"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-07-22T02:00:09.085Z","response_time":66,"last_error":null,"robots_txt_status":null,"robots_txt_updated_at":null,"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":["checkmk","checkmk-extension","matrix","matrix-org","monitoring","notification-service","omd","synapse"],"created_at":"2024-11-15T22:18:57.732Z","updated_at":"2025-07-22T13:34:42.899Z","avatar_url":"https://github.com/bashclub.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Check_mk notifications in Matrix\n\nThis scripts gives your Check_mk installation a possibility to send notifications into [Matrix](https://matrix.org) chatroom.\n\n## Installation\n\nTo install this script do the following:\n\n1. Copy matrix.py file contents into clipboard.\n2. Execute ``omd su SITENAME``, where ``SITENAME`` is a site name for OMD. If you're using check_mk installed from source - skip this step.\n3. Open ``~/local/share/check_mk/notifications/matrix.py`` for editing and paste ``matrix.py`` file contents into it. Make it executable (``chmod +x ~/local/share/check_mk/notifications/matrix.py``). Check_mk installed from source can place it's files somewhere else and admins of these installations should figure out by themselves where to put this file.\n\n### Dependencies\n\nThis script has no dependencies except Python 3. It was written specifically to be very compact and understandable.\n\n## Configuration\n\nThis script will send notifications as user, so you should create a separate user for it. Consult your homeserver's documentation about instructions.\n\nYou'll need these parameters:\n\n* Homeserver URL - this is what you're specifying in Riot and other clients.\n* Notification bot user's token. To get it log in as created user, tap on settings icon in bottom left part of Riot and scroll in the very end.\n* Room ID. It's available in room settings.\n\nAfter obtaining all of them you should create new notification with parameters like this:\n\n![Check_mk notifications configuration](/check_mk_notifications_configuration.png)\n\nWhere 1st parameter is a homeserver URL (with http or https), second parameter is a bot user's access token and third parameter is a room ID.\n\n## How it will look like?\n\n![Check_mk notifications example](/notifications_in_matrix.png)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbashclub%2Fcheck_mk_matrix_notifications","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbashclub%2Fcheck_mk_matrix_notifications","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbashclub%2Fcheck_mk_matrix_notifications/lists"}