thethingsnetwork/lorawan-stack repository overview

The Things Stack for LoRaWAN is an open source LoRaWAN network stack suitable for large, global and geo-distributed public and private networks as well as smaller networks. The architecture follows the LoRaWAN Network Reference Model for standards compliancy and interoperability. This project is actively maintained by The Things Industries⁠.

LoRaWAN is a protocol for low-power wide area networks. It allows for large scale Internet of Things deployments where low-powered devices efficiently communicate with Internet-connected applications over long range wireless connections.

⁠Features

• LoRaWAN Network Server
  • Supports LoRaWAN 1.1
  • Supports LoRaWAN 1.0, 1.0.1, 1.0.2 and 1.0.3
  • Supports LoRaWAN Regional Parameters 1.0, 1.0.2 rev B, 1.0.3 rev A, 1.1 rev A and B
  • Supports Class A devices
  • Supports Class B devices
  • Supports Class C devices
  • Supports OTAA devices
  • Supports ABP devices
  • Supports MAC Commands
  • Supports Adaptive Data Rate
  • Implements LoRaWAN Back-end Interfaces 1.0
• LoRaWAN Application Server
  • Payload conversion of well-known payload formats
  • Payload conversion using custom JavaScript functions
  • MQTT pub/sub API
  • HTTP Webhooks API
  • Implements LoRaWAN Back-end Interfaces 1.0
• LoRaWAN Join Server
  • Supports OTAA session key derivation
  • Supports external crypto services
  • Implements LoRaWAN Back-end Interfaces 1.0 and 1.1 draft 3
• OAuth 2.0 Identity Server
  • User management
  • Entity management
  • ACLs
• GRPC APIs
• HTTP APIs
• Command-Line Interface
  • Create account and login
  • Application management and traffic
  • End device management, status and traffic
  • Gateway management and status
• Web Interface (Console)
  • Create account and login
  • Application management and traffic
  • End device management, status and traffic
  • Gateway management, status and traffic

⁠Getting Started

You want to install The Things Stack? Fantastic! Here's the Getting Started guide⁠.

Do you want to set up a local development environment? See the DEVELOPMENT.md⁠ for instructions.

Do you want to contribute to The Things Stack? Your contributions are welcome! See the guidelines in CONTRIBUTING.md⁠.

Are you new to LoRaWAN and The Things Network? See the general documentation at thethingsnetwork.org/docs⁠.

⁠Commitments and Releases

Open source projects are great, but a stable and reliable open source ecosystem is even better. Therefore, we make the following commitments:

1. We will not break the API towards gateways and applications within the major version. This includes how gateways communicate and how applications work with data
2. We will upgrade storage from older versions within the major version. This means that you can migrate an older setup without losing data
3. We will not break the public command-line interface and configuration within the major version. This means that you can safely build scripts and migrate configurations
4. We will not break the API between components and events within minor versions. So at least the same minor versions of components are compatible with each other

As we are continuously adding functionality in minor versions and fixing issues in patch versions, we are also introducing new configurations and new defaults. We therefore recommend reading the release notes before upgrading to a new version.

You can find the releases and their notes on the Releases page⁠.

⁠Support

• The forum⁠ contains a large amount of information and has great search support.
• You can chat in the #lorawan-stack channel on Slack⁠. If you don't have a Slack account yet, you can create one by going to ttn.fyi/slack-invite⁠.
• Hosted solutions, as well as commercial support and consultancy are offered by The Things Industries⁠.