{"id":13721764,"url":"https://github.com/jamiew/helium-diy-hotspot","last_synced_at":"2025-05-07T14:30:43.031Z","repository":{"id":66289722,"uuid":"296631212","full_name":"jamiew/helium-diy-hotspot","owner":"jamiew","description":null,"archived":true,"fork":false,"pushed_at":"2020-11-05T03:37:56.000Z","size":11,"stargazers_count":3,"open_issues_count":0,"forks_count":0,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-05-05T00:12:10.677Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/jamiew.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null}},"created_at":"2020-09-18T13:37:37.000Z","updated_at":"2023-01-28T12:02:25.000Z","dependencies_parsed_at":"2024-01-06T01:08:33.266Z","dependency_job_id":"8d0a1bb3-fbe1-4a09-b73e-a145fb86f2e5","html_url":"https://github.com/jamiew/helium-diy-hotspot","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamiew%2Fhelium-diy-hotspot","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamiew%2Fhelium-diy-hotspot/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamiew%2Fhelium-diy-hotspot/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/jamiew%2Fhelium-diy-hotspot/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/jamiew","download_url":"https://codeload.github.com/jamiew/helium-diy-hotspot/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252895472,"owners_count":21821167,"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":[],"created_at":"2024-08-03T01:01:21.071Z","updated_at":"2025-05-07T14:30:42.668Z","avatar_url":"https://github.com/jamiew.png","language":"Shell","funding_links":[],"categories":["Software"],"sub_categories":["DIY Hotspots"],"readme":"**DEPRECATED**\n\n**This repository is not actively maintained and is provided as reference only.** For a more active project please try [Wheaties466/helium_miner_scripts](https://github.com/Wheaties466/helium_miner_scripts)\n\n\nhelium-diy-hotspot\n==================\n\nSome setup and update scripts for a DIY Helium hotspot based\non the RAK2244 Pilot Gateway -- which uses the sx1301 chip\n\nIf you're using a RAK2287 with the sx1302, you'll need to adjust\nthe gateway/packet_forwarder setup. There are other good guides for that:\n\n* https://github.com/maco2035/DiyHeliumHotspots/blob/master/RAK2287/Raspberry%20Pi%204B/Guide.md\n\nSetup\n-----\n\nFollow the usual instructions for setting up rpi4 and \ncompiling gateway \u0026 lora_packet_forwarder, from [developer.helium.com \"How to build a hotspot\"](https://developer.helium.com/hotspot/developer-setup)\n\nThen checkout this repository and initialize our submodules:\n\n```\ngit checkout https://github.com/jamiew/helium-diy-hotspot \ncd helium-diy-hotspot\ngit submodule init\n```\n\n\nPacket Forwarder\n----------------\n\nFirst, compile the packet_forawrder per Helium \"how to build a hotspot\" instructions above if you haven't already\n\nThen instead of running directly, setup the systemd script and rsyslog drain for the packet forwarder. The systemd\nscript will make the packet forwarder run at boot.\n\n```\nsudo cp systemd/lora_pkt_fwd.service /etc/systemd/system/\nsudo systemctl daemon-reload\nsudo systemctl enable lora_pkt_fwd.service\n\nsudo cp rsyslogd/lora_pkt_fwd.conf /etc/rsyslog.d/\nsudo systemctl restart rsyslog\n```\n\nYou should see some logs coming to `/var/log/lora_pkt_fwd.log`, or use:\n\n```\n./logs-forwarder.sh\n```\n\n\nMiner\n-----\n\nTo run miner, use the `./update-miner.sh` script, which is a submodule checkout\nof https://github.com/Wheaties466/helium_miner_scripts\n\nThis uses docker, which you can install with:\n\n```\nsudo ./get-docker.sh\nsudo usermod -aG docker pi\n```\n\nThen run the docker container:\n\n```\n./run-miner.sh\n```\n\n(this currently aliases to the very-helpful ./update-miner.sh script, which fetches the latest\nminer build automatically)\n\nTODO add a cronjob to run ./update-miner.sh at at least daily! I've started running it hourly, and\narguably could run even more often. Most of the time it does nothing\n\n\nLogs/Monitoring\n---------------\n\nBasic log tailing for now\n\n```\n./logs-miner.sh\n```\n\n```\n./logs-forwarder.sh\n````\n\n\nLicense\n-------\n\nMIT. Pull requests welcome\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjamiew%2Fhelium-diy-hotspot","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fjamiew%2Fhelium-diy-hotspot","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fjamiew%2Fhelium-diy-hotspot/lists"}