Skip to content

nu-iot-lab/ts-lora-chirpstack

Repository files navigation

ChirpStack open-source LoRaWAN(R) Network Server (but it can do TS-LoRa)

How to compile and run the debug build?

I assume that you are running a clean installation of the Debian 13. The build might work on other systems, but I have not tested that. Here are the steps that you need to undertake to achieve the debug build optimized for the build speed, not for performance and reliablity:

  1. Open the bash shell either by using the GUI or by clicking Ctrl + Alt + T.
  2. Install git to able to conveniently downliad the source code of this program (I assume that you are logged in as a non-root user who can do sudo):
   sudo apt update
   sudo apt install git -y
  1. Move to the Documents folder (it is optional, everything is fine as long as your shell session is located in one of the subdirectiories of the HOME folder)
   cd ~/Documents]
  1. Download this project's (i.e. ts-lora chirpstack) source code from Github:
   git clone https://github.com/ts-lora/ts-lora-chirpstack.git
  1. Move to the project's directory:
   cd ts-lora-chirpstack
  1. Install curl to be able to download Nix:
   sudo apt install curl -y
  1. Install xz-util to be able to unpack Nix:
   sudo apt install xz-utils -y
  1. Install Nix (it is a package manager):
  sh <(curl -L https://nixos.org/nix/install) --no-daemon
  . /home/bob/.nix-profile/etc/profile.d/nix.sh
  1. Restart the shell session:
   exec $SHELL
  1. Install docker engine through its convenience script:
   curl -fsSL https://get.docker.com -o install-docker.sh
   sudo sh install-docker.sh
  1. Allow to run the docker engine commands as a non-root user:
   sudo groupadd docker
   sudo usermod -aG docker $USER
   newgrp docker
  1. Start the development shell:
   nix-shell
  1. Build the Chirpstack UI:
    $ make build-ui
  1. Run the required services for the Chirpstack
    $ docker compose up -d
  1. Run the Chirpstack tests (optional):
   $ make test
  1. Install the Chirpstack's dependencies:
    $ make dev-dependencies
  1. Do the debug build:
    $ cd chirpstack
    $ make debug-amd64
  1. Run chirpstack
    $ cd chirpstack
    $ cargo run -- --config-dir configuration

License

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

About

No description, website, or topics provided.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Sponsor this project

 

Packages

 
 
 

Contributors