{"id":13464765,"url":"https://github.com/chirpstack/chirpstack-gateway-os","last_synced_at":"2025-04-05T01:03:10.125Z","repository":{"id":42373203,"uuid":"162586689","full_name":"chirpstack/chirpstack-gateway-os","owner":"chirpstack","description":"OpenWrt based gateway images including ChirpStack components.","archived":false,"fork":false,"pushed_at":"2024-10-28T09:26:52.000Z","size":1254,"stargazers_count":132,"open_issues_count":5,"forks_count":57,"subscribers_count":19,"default_branch":"master","last_synced_at":"2024-10-29T17:55:17.352Z","etag":null,"topics":["chirpstack","gateway","iot","lora","lorawan","openwrt"],"latest_commit_sha":null,"homepage":"https://www.chirpstack.io","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/chirpstack.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":".github/FUNDING.yml","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,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"chirpstack"}},"created_at":"2018-12-20T13:57:17.000Z","updated_at":"2024-10-28T09:26:57.000Z","dependencies_parsed_at":"2023-11-13T15:05:25.385Z","dependency_job_id":"b7eeb500-e20d-4902-886b-edaabc76bf62","html_url":"https://github.com/chirpstack/chirpstack-gateway-os","commit_stats":null,"previous_names":["brocaar/chirpstack-gateway-os"],"tags_count":49,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chirpstack%2Fchirpstack-gateway-os","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chirpstack%2Fchirpstack-gateway-os/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chirpstack%2Fchirpstack-gateway-os/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/chirpstack%2Fchirpstack-gateway-os/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/chirpstack","download_url":"https://codeload.github.com/chirpstack/chirpstack-gateway-os/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247271514,"owners_count":20911587,"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":["chirpstack","gateway","iot","lora","lorawan","openwrt"],"created_at":"2024-07-31T14:00:49.994Z","updated_at":"2025-04-05T01:03:10.104Z","avatar_url":"https://github.com/chirpstack.png","language":"Shell","readme":"# ChirpStack Gateway OS\n\nChirpStack Gateway OS is an open-source [OpenWrt](https://openwrt.org/) based\nembedded OS for LoRa\u003csup\u003e\u0026reg;\u003c/sup\u003e gateways. It provides a web-interface for\nconfiguration and contains pre-defined configuration options for common\nLoRa hardware to make it easy to setup a LoRa gateway and optionally a\nChirpStack-based LoRaWAN\u003csup\u003e\u0026reg;\u003c/sup\u003e Network Server.\n\n**Note:** If you are looking for the [Yocto](https://www.yoctoproject.org/)\nrecipes of the previously Yocto based ChirpStack Gateway OS, please switch to\nthe [v4_yocto](https://github.com/chirpstack/chirpstack-gateway-os/tree/v4_yocto)\nbranch.\n\n## Documentation and binaries\n\nPlease refer to the [ChirpStack Gateway OS documentation](https://www.chirpstack.io/docs/chirpstack-gateway-os/)\nfor documentation and pre-compiled images.\n\n## Building from source\n\n### Requirements\n\nBuilding ChirpStack Gateway OS requires:\n\n* [Docker](https://www.docker.com/)\n\n### Initialize\n\nTo initialize the [OpenWrt](https://openwrt.org/) build environment, run the\nfollowing command:\n\n```bash\nmake init\n```\n\nThis will:\n\n* Clone the OpenWrt code\n* Fetch all the OpenWrt feeds, including the [ChirpStack OpenWrt Feed](https://github.com/chirpstack/chirpstack-openwrt-feed)\n* Symlink configuration and files\n\n### Update\n\nThis step is not required after running `make init`, but allows you to update\nthe OpenWrt source and feeds at a later point:\n\n```bash\nmake update\n```\n\n### Build\n\nFor building the ChirpStack Gateway OS, you must enter the Docker-based\ndevelopment environment first:\n\n```\nmake devshell\n```\n\n#### Switch configuration\n\nEach target and image has its own OpenWrt configuration file, files and\npatches. These can be found under the `conf` directory of this repository.\n\nTo switch to one of these configuration environments, you must execute:\n\n```\nmake switch-env ENV=name-of-env\n```\n\nFo example if you would like to switch to `base_raspberrypi_bcm27xx_bcm2709`,\nyou execute:\n\n```\nmake switch-env ENV=base_raspberrypi_bcm27xx_bcm2709\n```\n\nThis will:\n\n* Undo all previously applied patches.\n* Update the symlinks for OpenWrt configuration and files.\n* Apply all patches. \n\n#### Building image\n\nOnce the configuration has been set, run the following command to build the\nChirpStack Gateway OS image:\n\n```bash\nmake\n```\n\nNote that this can take a couple of hours depending on the selected\nconfiguration and will require a significant amount of disk-space.\n\n#### Making configuration changes\n\n**Note:** The commands listed below must be executed within the `openwrt`\ndirectory.\n\nTo make configuration changes (e.g. add additional packages), you can execute:\n\n```bash\nmake menuconfig\n```\n\nAs updates to OpenWrt packages can introduce new configuration options over\ntime, you can run the following command to update the configuration:\n\n```bash\nmake defconfig\n```\n\nPlease refer also to the [OpenWrt build system usage documentation](https://openwrt.org/docs/guide-developer/toolchain/use-buildsystem).\n\n## Links\n\n* [ChirpStack documentation](https://www.chirpstack.io/)\n* [chirpstack-openwrt-feed](https://github.com/chirpstack/chirpstack-openwrt-feed) repository\n","funding_links":["https://github.com/sponsors/chirpstack"],"categories":["Shell"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchirpstack%2Fchirpstack-gateway-os","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fchirpstack%2Fchirpstack-gateway-os","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fchirpstack%2Fchirpstack-gateway-os/lists"}