09 · License Management

License Management

A license is a 16-character key that has an assigned number of allowed Receivers (Device Limit). When you activate the license, this Device Limit is injected into the Master device, allowing the Master to operate that many Receivers. This document covers activation and connection diagnostics only.

License Overview#

Item	Description
License key	16-character key (issued at tally-node.com)
Device Limit	Number of allowed Receivers assigned to the license
Injection target	Master device (only the Master handles licensing)
Result	On activation, the Device Limit is injected into the Master →operate Receivers within the limit

One license per Master

Activate one license per Master. Receivers do not need their own license.

If the license is not activated or the Device Limit has not been injected, TX/RX communication is restricted and the Receiver enters the STOP state. (See Behavior on Invalid License.)

License Activation (Device Limit Injection)#

Activation Procedure#

1
Open the License menu
Click the License menu in the Master Web UI
2
Enter the license key
Enter the 16-character license key
3
Click Activate
The Master queries the Device Limit for that license from the tally-node.com server
4
Device Limit injected
The Device Limit is injected into the Master →Receivers can be operated within the limit

Internet connection required

An internet connection is required. If the server cannot be reached, run the Internet Diagnostics.

Activation Failure#

Error	Cause	Solution
Invalid key	Key typo or unissued key	Recheck the key and re-enter
Connection failed	Internet/server connection problem	Run internet diagnostics
Server error	License server outage	Retry after a while

License Server Connection Failure →Internet Diagnostics#

If the license server cannot be reached (activation failure, Connection failed), use the Internet Connection Test on the License page to narrow down the cause step by step.

Three-step diagnostics#

Step	Test	Target
1	DNS (8.8.8.8)	Internet connectivity itself
2	License Server (tally-node.com)	License server reachability
3	DB	License database health + response latency

Actions on failure#

Failed step	Cause	Solution
DNS failure	No internet / DNS blocked	Check the network cable/WiFi, allow router DNS (8.8.8.8), open firewall port 53 (UDP)
License Server failure	tally-node.com blocked / proxy or firewall	Whitelist tally-node.com, open port 443 (HTTPS)
DB failure	Server DB maintenance / overload	Retry after a while

Diagnostic flow

Flow: activation failure →Internet Connection Test →check sequentially from step 1 (DNS) →apply the action for the failed step →retry activation.

Behavior on Invalid License (Receiver STOP & Recovery)#

If the license is invalid or the Device Limit has not been injected, the Receiver transitions to the STOP state.

Receiver STOP behavior#

1
Detect invalid/not-injected state
The Master detects the invalid/not-injected state →sends STOP over LoRa
2
Wireless TX/RX halted
Receiver wireless TX/RX halted (radio-silent)
3
OLED overlay shown
A "STOPPED / LICENSE REQUIRED" overlay is shown on the OLED
4
LEDs off
All LEDs turned off (all-OFF)
5
Button input blocked
Receiver button input is blocked

No auto-release

Important: The STOP state is not released automatically. Follow the recovery procedure below.

Recovery Procedure#

Reactivate the license: on the Master Web UI License page, reactivate the license →confirm the Device Limit injection
Physically reboot the Receiver: physically reboot the Receiver (disconnect power → reconnect)
Verify normal operation: after the Receiver boots normally, confirm that tally operation resumes (see Receiver Operation)

Reboot required

Without rebooting the Receiver, the STOP state persists.

Last modified —