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
  • Uptime
  • Link to close session

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