ChirpStack open-source LoRaWAN Network Server
Go to file
2023-11-10 15:56:01 +00:00
.cargo Implement fully static ARMv7 build. 2023-05-30 12:13:52 +01:00
.docker-compose/postgresql/initdb Initial commit. 2022-04-06 21:18:32 +01:00
.github Update dist workflow. 2023-05-30 12:13:52 +01:00
api api: Update Go dependencies. 2023-11-02 14:23:31 +00:00
backend Add the misspelled UnkownReceiver as a valid ResultCode in BE () 2023-11-10 15:56:01 +00:00
chirpstack Simplify AWS SNS integration / reduce dependencies. 2023-11-09 13:22:10 +00:00
chirpstack-integration Bump version to 4.6.0-test.1 2023-10-26 15:38:37 +01:00
cross Update pq, zlib and openssl versions. 2023-09-05 10:44:08 +01:00
examples Expose skip_f_cnt and device variables to ADR. 2023-10-09 11:23:13 +01:00
lrwn Refactor JS join_eui to join_eui_prefix. 2023-10-30 15:44:34 +00:00
lrwn-filters Bump version to 4.6.0-test.1 2023-10-26 15:38:37 +01:00
ui ui: Fix setting initial tagsMap in TenantForm. 2023-11-07 09:46:02 +00:00
.dockerignore Implement fully static AMD64 build. 2023-05-30 12:13:52 +01:00
.env Add dotenv for test dependency config. 2023-05-30 12:13:52 +01:00
.gitattributes Update .gitattributes. 2022-04-06 21:50:23 +01:00
.gitignore Add dotenv for test dependency config. 2023-05-30 12:13:52 +01:00
Cargo.lock Simplify AWS SNS integration / reduce dependencies. 2023-11-09 13:22:10 +00:00
Cargo.toml Add chirpstack_integration crate. 2023-10-13 11:38:56 +01:00
Cross.toml Implement fully static ARMv7 build. 2023-05-30 12:13:52 +01:00
docker-compose.yml Update README and Makefiles. 2023-05-30 12:13:52 +01:00
Dockerfile Refactor build scripts for cross-rs based cross compiling. 2023-05-30 12:13:52 +01:00
Dockerfile-devel Refactor build scripts for cross-rs based cross compiling. 2023-05-30 12:13:52 +01:00
LICENSE Initial commit. 2022-04-06 21:18:32 +01:00
Makefile Add chirpstack_integration crate. 2023-10-13 11:38:56 +01:00
README.md Update README + remove Vagrantfile. 2023-05-31 12:11:48 +01:00
rust-toolchain.toml Update Rust to v1.73.0. 2023-10-16 11:30:01 +01:00
shell.nix Refactor UI to function elements & update React + Ant. 2023-07-27 13:07:00 +01:00

ChirpStack open-source LoRaWAN(R) Network Server

CI

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 website for documentation and pre-compiled binaries.

Building from source

Requirements

Building ChirpStack requires:

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:

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 for cross-compiling, as well as some of the make commands.

Starting the development shell

Run the following command to start the development shell:

nix-shell

Or if you do not have Nix installed, execute the following command:

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:

docker-compose up -d

Run tests

Run the following command to run the ChirpStack tests:

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:

make dev-dependencies

Run the following command within the ./chirpstack sub-folder:

# 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

License

ChirpStack Network Server is distributed under the MIT license. See also LICENSE.