{"id":19398368,"url":"https://github.com/quarkiverse/quarkus-systemd-notify","last_synced_at":"2025-06-13T22:36:41.501Z","repository":{"id":103105933,"uuid":"572529600","full_name":"quarkiverse/quarkus-systemd-notify","owner":"quarkiverse","description":"This project demonstrates integrating systemd-notify with Quarkus","archived":false,"fork":false,"pushed_at":"2025-05-07T13:25:04.000Z","size":167,"stargazers_count":9,"open_issues_count":3,"forks_count":0,"subscribers_count":4,"default_branch":"main","last_synced_at":"2025-06-03T21:14:40.214Z","etag":null,"topics":["linux","quarkus","quarkus-extension","systemd","systemd-notify"],"latest_commit_sha":null,"homepage":"","language":"Java","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/quarkiverse.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":".github/CODEOWNERS","security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2022-11-30T13:25:05.000Z","updated_at":"2025-06-03T01:42:50.000Z","dependencies_parsed_at":null,"dependency_job_id":"9cc70837-6d49-47e3-8e3b-34aaca552e02","html_url":"https://github.com/quarkiverse/quarkus-systemd-notify","commit_stats":null,"previous_names":[],"tags_count":5,"template":false,"template_full_name":null,"purl":"pkg:github/quarkiverse/quarkus-systemd-notify","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quarkiverse%2Fquarkus-systemd-notify","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quarkiverse%2Fquarkus-systemd-notify/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quarkiverse%2Fquarkus-systemd-notify/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quarkiverse%2Fquarkus-systemd-notify/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/quarkiverse","download_url":"https://codeload.github.com/quarkiverse/quarkus-systemd-notify/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/quarkiverse%2Fquarkus-systemd-notify/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":259731012,"owners_count":22902954,"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","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":["linux","quarkus","quarkus-extension","systemd","systemd-notify"],"created_at":"2024-11-10T11:05:51.369Z","updated_at":"2025-06-13T22:36:41.471Z","avatar_url":"https://github.com/quarkiverse.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Quarkus Systemd Notify Extension\n\n\u003c!-- ALL-CONTRIBUTORS-BADGE:START - Do not remove or modify this section --\u003e\n[![All Contributors](https://img.shields.io/badge/all_contributors-1-orange.svg?style=flat-square)](#contributors-)\n\u003c!-- ALL-CONTRIBUTORS-BADGE:END --\u003e\n\n[![Version](https://img.shields.io/maven-central/v/io.quarkiverse.systemd.notify/quarkus-systemd-notify?logo=apache-maven\u0026style=flat-square)](https://search.maven.org/artifact/io.quarkiverse.systemd.notify/quarkus-systemd-notify)\n\n## Introduction\n\nThis extension is used to notify Linux service manager (systemd) about start-up completion and other service status changes.\n\n## Usage\n\nTo use the extension, add the dependency to the target project:\n\n```\n\u003cdependency\u003e\n    \u003cgroupId\u003eio.quarkiverse.systemd.notify\u003c/groupId\u003e\n    \u003cartifactId\u003equarkus-systemd-notify\u003c/artifactId\u003e\n    \u003cversion\u003e${quarkus.systemd.notify.version}\u003c/version\u003e\n\u003c/dependency\u003e\n```\n\nand configure the service unit file with the following minumum configurations:\n\n```\n...\n\n[Service]\nType=notify\nAmbientCapabilities=CAP_SYS_ADMIN\n\n...\n```\n\n## Systemd Service Example\n\nAssuming `quarkus-run.jar` is located at `/opt/quarkus-app/quarkus-run.jar`:\n\n- Create a unit configuration file at `/etc/systemd/system/quarkus.service`:\n\n```\n[Unit]\nDescription=Quarkus Server\nAfter=network.target\nWants=network.target\n\n[Service]\nType=notify\nAmbientCapabilities=CAP_SYS_ADMIN\nExecStart=/bin/java -jar /opt/quarkus-app/quarkus-run.jar\nSuccessExitStatus=0 143\n\n[Install]\nWantedBy=multi-user.target\n```\n- Enable the service (this will make it to run at system start-up as well):\n\n```\nsudo systemctl enable quarkus\n```\n\n- Start/Stop/Restart the service:\n\n```\nsudo systemctl start quarkus\nsudo systemctl stop quarkus\nsudo systemctl restart quarkus\n```\n\n- Check status of the service:\n\n```\nsudo systemctl status quarkus\n```\n\n## systemd-notify with SELinux\n\nIf SELinux (Mostly for RedHat OS) is enabled:\n\n```\nroot# getenforce\nEnforcing\n```\n\nAdd `systemd_notify_t` to the permissive types:\n\n```\nsemanage permissive -a systemd_notify_t\n```\n\nYou can check with:\n\n```\nsemanage permissive -l\n```\n\nYou may need to execute this as well:\n\n```\nsudo /sbin/restorecon -v /etc/systemd/system/quarkus.service\n```\n\n## Contributors ✨\n\nThanks goes to these wonderful people ([emoji key](https://allcontributors.org/docs/en/emoji-key)):\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:START - Do not remove or modify this section --\u003e\n\u003c!-- prettier-ignore-start --\u003e\n\u003c!-- markdownlint-disable --\u003e\n\u003ctable\u003e\n  \u003ctbody\u003e\n    \u003ctr\u003e\n      \u003ctd align=\"center\"\u003e\u003ca href=\"https://fouad.io\"\u003e\u003cimg src=\"https://avatars.githubusercontent.com/u/1194488?v=4?s=100\" width=\"100px;\" alt=\"Fouad Almalki\"/\u003e\u003cbr /\u003e\u003csub\u003e\u003cb\u003eFouad Almalki\u003c/b\u003e\u003c/sub\u003e\u003c/a\u003e\u003cbr /\u003e\u003ca href=\"https://github.com/quarkiverse/quarkus-systemd-notify/commits?author=Eng-Fouad\" title=\"Code\"\u003e💻\u003c/a\u003e \u003ca href=\"#maintenance-Eng-Fouad\" title=\"Maintenance\"\u003e🚧\u003c/a\u003e\u003c/td\u003e\n    \u003c/tr\u003e\n  \u003c/tbody\u003e\n\u003c/table\u003e\n\n\u003c!-- markdownlint-restore --\u003e\n\u003c!-- prettier-ignore-end --\u003e\n\n\u003c!-- ALL-CONTRIBUTORS-LIST:END --\u003e\n\nThis project follows the [all-contributors](https://github.com/all-contributors/all-contributors) specification. Contributions of any kind welcome!\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquarkiverse%2Fquarkus-systemd-notify","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fquarkiverse%2Fquarkus-systemd-notify","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fquarkiverse%2Fquarkus-systemd-notify/lists"}