/lorawan-server

Compact server for private LoRaWAN networks

Primary LanguageErlangMIT LicenseMIT

Compact server for private LoRaWAN networks

Open-source LoRaWAN Server that integrates both the network-server and the application-server. This is useful for application providers that operate their own LoRaWAN network, or for device and application developers.

Warning This is a development version 0.7.0. Use the stable 0.6.x instead, please. After a major version upgrade you are required to review and complete the configuration before connecting any gateway or device!

  • After migrating to 0.7.x you need to
    • Remove the /admin suffix from Server -> Admin URL.
    • Make sure all Gateways are assigned to an Area with a specified Region.
  • After migrating from version 0.5.x to 0.6.x you need to assign Profiles to Groups and Gateways to Areas.
  • Migrating from version 0.4.x to 0.5.x will preserve the Device/Node addresses and security keys, but will delete many ADR parameters, which got moved to the Profile settings.

The server:

The server aims to be an all-in-one software package for small private LoRaWAN networks. However:

  • You still need to buy your LoRaWAN Gateway.
  • You will need to deploy and maintain it yourself. (With my support.)
  • It will probably never support the sophisticated management features of the commercial-grade network-servers.

The maximum amount of gateways, devices and nodes the server can support depends on the server load and hardware performance. There are no hard limits.

The API may change and some functions may not be implemented. To ask questions or request features please join the lorawan-server mailing list. We will gladly assist you. If you find a bug, you may also add an Issue.

Documentation

The lorawan-server includes all functions required to run a private LoRaWAN network. It integrates your LoRaWAN network directly with your backend IT systems. The server is provided as a comprehensive package with a single configuration file and a single administration tool. You only need to install the Erlang/OTP 21.0 or higher.

The main components of the lorawan-server are shown in the following figure:

alt tag

Usage

The server behaviour is described in the Introduction.

The Installation Instructions describe how to build, install and upgrade the server. You can use a Debian package, download the binary release and run it manually or build the server from source codes.

Follow the Configuration Instructions to correctly setup your server.

Run the lorawan-server release by:

cd lorawan-server
bin/lorawan-server

Don't forget to set the server address and port (by default 1680) in the LoRaWAN gateways you want to use with the server.

You can terminate the lorawan-server by:

bin/lorawanctl stop

You can administrate and manage the server via a set of web-pages or via a REST API as described in the Administration Guide. By default you can access the administration at http://server:8080, using "admin" as both username and password. After the installation you have to:

  • Change the default password to something more secure.
  • Set parameters of your Network and add LoRaWAN Gateways you want to use.
  • Define the device Profiles, one for each device type that you will have.
  • Configure each device you want to use, either as a personalized Node (ABP) or as an Commissioned and over-the-air activated (OTAA) device.

Integration

You can integrate lorawan-server with external applications using Backend Handlers and Connectors. Instructions on how to integrate with some major clouds such as AWS or Azure are provided in the Integration Guide.

You can also use the internal web server and develop internal applications, which may offer custom REST APIs. The lorawan-server is designed to be highly extensible. I encourage you to Learn You Some Erlang and develop your own modules.

To implement an internal application you need to create a new module implementing the lorawan_application behaviour as described in the Custom Application Guide and Development Guide.

Troubleshooting

Build Status

First of all, please read the documentation.

If the server doesn't do what you expect, please review the server logs and consult the Troubleshooting Instructions for the most common problems.

If the problem persists, please verify you have the latest version. I recommend to always use the latest release. If you use the latest sources, please verify the "build" icon above is green and then try upgrading by running:

cd lorawan-server
git pull
make upgrade
make release

If the "build" icon above is red, please wait few minutes (or hours) until it gets green again.

If nothing helps, please contact the lorawan-server mailing list or review the existing issues to verify the problem was not already reported and then create new issue.

Public References

The server is used (both commercially and non-commercially) by various companies and institutions. It was mentioned by the following blogs and articles:

Please let me know if you use the lorawan-server and want to be listed here.

Copyright and Licensing

The lorawan-server is distributed under the terms of the MIT License. See the LICENSE.

Copyright (c) 2016-2019 Petr Gotthard

Sponsors

Softline is a leading global Information Technology solutions and services provider focused on emerging markets such as Eastern Europe, Central Asia, Americas, and Asia. We help our customer achieve digital transformation and protect their business with cybersecurity technologies. Our services include end-to-end technology solutions, public and private clouds, software and hardware provisioning and broad array of associated services.