Articles on: Tools & Utilities

Astra HTTP Relay

Astra HTTP Relay is a simple built-in tool to retransmit data from any source supported by Astra to HTTP client.


astra --relay -p 8000

Command line arguments:

-p 8000 - local port for incomming connections. Default: `8000`;
-a - local IP address for incomming connections. Default - accept request on any interface;
-l - IP address of the local interface to receive UDP/RTP streams. Default - receives streams according to system routing table;
--pass login:password - login and password for basic authorization for all requests;
--no-udp - disable access to the UDP/RTP source;
--no-http - disable access to the HTTP source;
--buffer-size 1024 — the maximum buffer size in kilbytes for each client. Default 1024Kb;
--buffer-fill 128 — defines number of kilobytes to fill in buffer before start transmission. Default 128Kb;
--daemon - start in daemon mode;
--log /var/log/relay.log - full path to the log file;
--channels /etc/astra/relay.lua - full path to the channel aliases.

Address format

Request address has next format:

http://your-server-address:8000/udp/ - receives UDP stream from multicast group
http://your-server-address:8000/http/ - receives HTTP stream from

Channel aliases

Channel aslias let to use short name instead of full address. Alias list example:

-- /etc/astra/relay.conf

channels = {
    ["demo"] = "udp://",
    ["travel-channel"] = ""

Launch relay with path to the alias list:

astra --relay -p 8000 --channels /etc/astra/relay.conf

Channels from example above will be availble on:

http://your-server-address:8000/demo - UDP stream
http://your-server-address:8000/travel-channel - HTTP stream


Statistics is a simple page with active sessions contain next information:

Client IP address
Request path - alias or full address of the source channel
Link to close session

To view statistics, open in your browser: http://your-server-address:8000/stat/

Updated on: 23/02/2023

Was this article helpful?

Share your feedback


Thank you!