Astra. Quick Start

Install and Update

After installation you may do next steps:

Launch Astra

General parameters:

  • -h — print help message and exit
  • -v — print version number and exit
  • --no-stdout — disable logging to the console
  • --log PATH — write log to the file
  • --syslog NAME — send log to the syslog with defined process name
  • --pid PATH — full path to the pidfile
  • --daemon — start as a daemon
  • --license PATH — full path to the license.txt


  • -c CONFIG — full path to the configuration file. File will be created on the first run
  • -p PORT — port to access to the web-interface and API
  • OPTIONS — general parameters
  • SCRIPTS — additional scripts

After the launch, web-interface will be available on http://server-address:port/

To configure an autorun after a server restart please, read this manual: Astra: Autorun

Migration to Astra 5

You may import your Scripts or JSON-configuration from older versions of Astra (4.4 and older):

  1. Launch Astra with empty configuration file
  2. Open web interface in your browser
  3. Navigate to Settings -> Import
  4. Paste Script or JSON-configuration then press Import button
  5. Apply changes

Astra 4.4 Scripts is compatible with Astra 5.

Additional utilities

MPEG-TS Analyzer

Check information and quality about the streams.

astra --analyze ADDRESS [OPTIONS]
  • ADDRESS — source address. Read more: Media Address Format
  • -n SEC — exit after the defined time
  • -o FILE — save stream into the file

Launch MPEG-TS Analyzer with web-interface

astra --analyze -p PORT [OPTIONS]
  • -p PORT — port for web-interface. By the default application works in console mode and web-interface is not available
  • OPTIONS — general parameters

After the launch, web-interface will be available on http://server-address:port/

UDP/HTTP Streams Relay

Forward UDP/HTTP streams via HTTP.

astra --relay [OPTIONS]
  • -a ADDR — IP-address of the local interface for incomming connections. Default value: (any interface)
  • -p PORT — port for incomming connections. Default value: 8000
  • -l ADDR — IP-address of the local interface to receive UDP/RTP streams, by the default uses system route table
  • --buffer-size SIZE — size of the connection buffer. Buffer allocated for each connection and allows to keep data before sending. Prevents data loss on transmission delays. Default value: 1024 kilobytes
  • --buffer-fill SIZE — minimum size of the sending packet in kilobytes. Default value: 128 kilobytes
  • --no-udp — disable direct access the to UDP/RTP source /udp/*, /rtp/*
  • --no-http — disable access the to HTTP source /http/*
  • --pass LOGIN:PASS — set login and password for access to the web-interface
  • --congestion TYPE — define tcp_congestion_control algorithm
  • SCRIPT — additional script

DVB Adapters Information

Print the detailed information about the DVB adapters

astra --dvbls

DVB Signal Status

Check signal quality

astra --femon -a ADAPTER [-r]
  • -a ADAPTER — is an adapter number
  • -r — signal level in dBm
astra --femon ADDRESS