Getting Started Devices Gateways The Things Stack Integrations Reference
Get The Things Stack

Reference

    Overview
  • Adaptive Data Rate
  • API
  • Application Packages
  • Billing with Stripe
  • Command-Line Interface
  • Components
    • Application Server
    • Command-line Interface
    • Console
    • Device Claiming Server
    • Device Template Converter
    • Gateway Configuration Server
    • Gateway Server
    • Identity Server
    • Join Server
    • Network Operations Center
    • Network Server
    • Packet Broker Agent
    • Tenant Billing Server
  • Configuration
  • Data Retention and Privacy
  • Device Claiming Configuration
  • Email Templates
  • Federated Authentication
  • Frequency Plans
  • FUOTA
  • Gateway RTT
  • Glossary
  • ID and EUI Constraints
  • Last Activity
  • LoRa Basics Station Implementation Guide
  • LoRaWAN Join Server Configuration
  • Packet Broker Routing
  • Packet Forwarders
  • Rate Limiting
  • Resource Limiting
  • Root Certificates
  • Telemetry
  • The Things Network

Gateway Configuration Server

The Gateway Configuration Server (GCS) generates configuration files for UDP gateways and manages gateway configuration and firmware updates for Basic Station and The Things Kickstarter gateways.

Basic Station CUPS

The Gateway Configuration Server implements the Basic Station CUPS protocol. Gateways implementing this protocol request the GCS for configuration via HTTP(s) POST request. These requests may require authentication in which case the gateway presents the appropriate credentials. The GCS responds to valid requests with a response that contains the URI of Gateway Server to which the gateway should connect.

This response optionally contains signed firmware update data that can be used to remotely update the firmware of supported gateways.

UDP Configuration File

The Gateway Configuration Server provides an endpoint to query the configuration file for a UDP gateway in JSON format. This allows automated scripts on supported gateways to request the configuration from the server periodically and apply changes in configuration, if applicable, without the need for shell access on the gateway. This configuration file can also be manually queried using API calls.

The Things Kickstarter Gateway

The Things Kickstarter Gateways connect to the Gateway Configuration Server to fetch key information such as the frequency plan to configure the gateway radio and the MQTT(s) server end point to connect for traffic. Additionally, the firmware of The Things Kickstarter Gateways can be remotely updated by the gateway itself by fetching the necessary files. The location of these files can also be configured per-gateway using the GCS.

← Device Template Converter Gateway Server →

On this page

  • Basic Station CUPS
  • UDP Configuration File
  • The Things Kickstarter Gateway

The Things Stack

Getting Started

Devices

Gateways

The Things Stack

Integrations

Reference

Contributing

GitHub

About Us

The Things Industries