{"id":13587813,"url":"https://github.com/pmalek/ethminer_watchdog","last_synced_at":"2025-07-28T18:07:04.853Z","repository":{"id":75780810,"uuid":"329087927","full_name":"pmalek/ethminer_watchdog","owner":"pmalek","description":"Run a watchdog on top of ethminer","archived":false,"fork":false,"pushed_at":"2022-04-17T10:24:01.000Z","size":690,"stargazers_count":5,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-10-29T10:52:25.058Z","etag":null,"topics":["ethereum","ethminer","linux","mining"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/pmalek.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":["pmalek"]}},"created_at":"2021-01-12T19:17:09.000Z","updated_at":"2024-03-21T04:18:15.000Z","dependencies_parsed_at":"2023-03-11T20:23:52.574Z","dependency_job_id":null,"html_url":"https://github.com/pmalek/ethminer_watchdog","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/pmalek/ethminer_watchdog","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pmalek%2Fethminer_watchdog","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pmalek%2Fethminer_watchdog/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pmalek%2Fethminer_watchdog/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pmalek%2Fethminer_watchdog/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/pmalek","download_url":"https://codeload.github.com/pmalek/ethminer_watchdog/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/pmalek%2Fethminer_watchdog/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":267560512,"owners_count":24107500,"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-28T02:00:09.689Z","response_time":68,"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":["ethereum","ethminer","linux","mining"],"created_at":"2024-08-01T15:06:22.424Z","updated_at":"2025-07-28T18:07:04.773Z","avatar_url":"https://github.com/pmalek.png","language":"Shell","funding_links":["https://github.com/sponsors/pmalek"],"categories":["Shell"],"sub_categories":[],"readme":"# ethminer_watchdog\n\nRun a watchdog on top of [`ethminer`](https://github.com/ethereum-mining/ethminer/)\n\n![Screenshot](/docs/screenshot.png)\n\n## What is this?\n\nFor a long time I was experimenting with some kind of a watchdog that would\nrestart my miners during internet outages, connection timeouts etc.\nAfter some time I've ended up with this script has worked well for me now for\ncouple of months already.\n\n## How to run\n\n### From the terminal\n\n```\n./ethminer_watchdog.sh\n```\n\nRequired environment variables to set:\n\n- `ETHMINER` - path to ethminer binary; default: `ethminer`\n- `ETHMINER_POOL_URL` - pool URL to use\n\n### As a `systemd` service\n\nIn order to run ethminer_watchdog as a `systemd` service you can use the following systemd unit file:\n\n```systemd\n[Unit]\nDescription=Ethminer systemd unit\n\n[Service]\nType=simple\nExecStart=\u003cpath_to_ethminer_watchdog.sh\u003e\nUser=\u003cyour_username\u003e\nEnvironment=FAN_SPEED=66\nEnvironment=POWER_LIMIT=95\nEnvironment=ETHMINER=\u003cpath_to_ethminer\u003e\nEnvironment=ETHMINER_POOL_URL=\u003cyour_miners_address\u003e\n\nRestartSec=10\nRestart=on-failure\n\nProtectSystem=strict\nProtectHome=read-only\nPrivateTmp=true\nTasksMax=16\n\n[Install]\nWantedBy=default.target\n```\n\nYou can run it as a `system` service by placing the above snippet in e.g. `/etc/systemd/system/ethminer.service`, reloading the `systemd` daemon:\n\n```shell\nsudo systemctl daemon-reload\n```\n\nand simply starting the service:\n\n```shell\nsudo systemctl start ethminer.service\n```\n\nLogs are available via `journalctl`:\n\n```\njournalctl --unit=ethminer.service --follow --lines 100\n```\n\n## Limitations\n\n- For now it runs only on Linux with `gdm` as display manager\n  (mostly because of `nvidia-settings` behavior)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpmalek%2Fethminer_watchdog","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fpmalek%2Fethminer_watchdog","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fpmalek%2Fethminer_watchdog/lists"}