Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/chirpstack/chirpstack
ChirpStack open-source LoRaWAN Network Server
https://github.com/chirpstack/chirpstack
chirpstack internet-of-things iot lora lorawan
Last synced: 4 days ago
JSON representation
ChirpStack open-source LoRaWAN Network Server
- Host: GitHub
- URL: https://github.com/chirpstack/chirpstack
- Owner: chirpstack
- License: mit
- Created: 2021-07-09T14:45:34.000Z (over 3 years ago)
- Default Branch: master
- Last Pushed: 2024-12-16T03:25:13.000Z (15 days ago)
- Last Synced: 2024-12-20T12:00:08.524Z (11 days ago)
- Topics: chirpstack, internet-of-things, iot, lora, lorawan
- Language: Rust
- Homepage: https://www.chirpstack.io/
- Size: 10 MB
- Stars: 613
- Watchers: 16
- Forks: 161
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
# ChirpStack open-source LoRaWAN(R) Network Server
ChirpStack is an open-source LoRaWAN(R) Network Server which can be used to set
up LoRaWAN networks. ChirpStack provides a web-interface for the management of
gateways, devices and tenants as well to set up data integrations with the major
cloud providers, databases and services commonly used for handling device data.
ChirpStack provides a gRPC based API that can be used to integrate or extend
ChirpStack.
## Documentation and binaries
Please refer to the [ChirpStack](https://www.chirpstack.io/) website for
documentation and pre-compiled binaries.
## Building from source
### Requirements
Building ChirpStack requires:
* [Nix](https://nixos.org/download.html) (recommended) and
* [Docker](https://www.docker.com/)
#### Nix
Nix is used for setting up the development environment which is used for local
development and for creating the binaries.
If you do not have Nix installed and do not wish to install it, then you can
use the provided Docker Compose based Nix environment. To start this environment
execute the following command:
```bash
make docker-devshell
```
**Note:** You will be able to run the test commands and run `cargo build`, but
cross-compiling will not work within this environment (because it would try start
Docker within Docker).
#### Docker
Docker is used by [cross-rs](https://github.com/cross-rs/cross) for cross-compiling,
as well as some of the `make` commands.
### Starting the development shell
Run the following command to start the development shell:
```bash
nix-shell
```
Or if you do not have Nix installed, execute the following command:
```bash
make docker-devshell
```
### Building the UI
To build the ChirpStack UI, execute the following command:
```
make build-ui
```
### Running ChirpStack tests
#### Start required services
ChirpStack requires several services like PostgresQL, Redis, Mosquitto, ...
to be running before you can run the tests. You need to start these services
manually if you started the development shell using `nix-shell`:
```bash
docker compose up -d
```
#### Run tests
Run the following command to run the ChirpStack tests:
```bash
# Test (with PostgresQL database backend)
make test
# Test with SQLite database backend
DATABASE=sqlite make test
```
### Building ChirpStack binaries
Before compiling the binaries, you need to install some additional development
tools (for cross-compiling, packaging, e.d.). Execute the following command:
```bash
make dev-dependencies
```
Run the following command within the `./chirpstack` sub-folder:
```bash
# Build AMD64 debug build (optimized for build speed)
make debug-amd64
# Build AMD64 release build (optimized for performance and binary size)
make release-amd64
# Build all packages (all targets, .deb, .rpm and .tar.gz files)
make dist
```
By default the above commands will build ChirpStack with the PostgresQL database
database backend. Set the `DATABASE=sqlite` env. variable to compile ChirpStack
with the SQLite database backend.
### Database migrations
To create a new database migration, execute:
```
make migration-generate NAME=test-migration
```
To apply migrations, execute:
```
make migration-run
```
To revert a migration, execute:
```
make migration-revert
```
By default the above commands will execute the migration commands using the
PostgresQL database backend. To execute migration commands for the SQLite
database backend, set the `DATABASE=sqlite` env. variable.
## License
ChirpStack Network Server is distributed under the MIT license. See also
[LICENSE](https://github.com/brocaar/chirpstack/blob/master/LICENSE).