Asteraid netinstall ISO Installation Guide

The Asteraid netinstall ISO is a minimal installation image for network-based deployment of the Asteraid management system.

Hardware Requirements

Component Physical Server Virtual Machine
CPU 1 CPU (Intel/AMD x86_64) 1 vCPU x86_64
Memory 2GB minimum 2GB minimum
Storage (OS only. Separate disk recommended for call recordings) 8GB minimum 8GB minimum
Network 1Gb Ethernet adapter (Wi-Fi not supported) Ethernet adapter in bridge mode (NAT not recommended)
Boot Mode BIOS or UEFI BIOS compatible
Note: These are minimum requirements. Production environments typically require more resources. 2 CPU Core and 8 GB of RAM should be sufficient in most cases.

Network Requirements

  • Stable Internet Connection: Minimum 5Mbps recommended
  • DHCP Network: Automatic IP configuration is required
  • Firewall Access: HTTP/HTTPS access to Asteraid repositories must be allowed
  • Proxy Configuration: Configure proxy settings if behind a corporate proxy

Installation Methods

Import OVA image

  1. Download OVA container
  2. Import container into hypervisor. Proxmox 6+, ESXi 7+ are supported. Follow your hypervisor's documentation to properly perform the container import operation.
  3. Connect the network adapter to the appropriate virtual switch. If you plan to import multiple virtual machines, carefully check the MAC addresses of the clones to avoid conflicts.
  4. Start the Guest
  5. Follow post-installation steps

Import Hyper-V image

  1. Download Hyper-V archive
  2. Unzip to new empty folder. Import content to hypervisor. Hyper-V Manager 10+ are supported
  3. Connect the network adapter to the appropriate virtual switch. If you plan to import multiple virtual machines, carefully check the MAC addresses of the clones to avoid conflicts.
  4. Start the Guest
  5. Follow post-installation steps

USB/DVD Installation

  1. Download Asteraid netinstall ISO
  2. For virtual machine connect ISO as bootable device
  3. In case of installation on hardware, create bootable media using:
    • Rufus (Windows)
    • Etcher (Mac/Linux)
    • root# dd if=/path/to/your/isofile of=/your/usb/disk bs=8M status=progress command (Linux)
  4. Boot from the media and follow the installation instructions

PXE Network Boot

  1. Download BIOS PXE image
  2. Download UEFI PXE image
  3. Example DHCP Configuration (Dnsmasq): dhcp-range=192.168.68.129,192.168.68.229,255.255.255.0,72h # BIOS boot mode by default dhcp-boot=ipxe.bios,, # UEFI boot for de:ad:be:af:00:00 dhcp-host=de:ad:be:af:00:00,set:efi-x64 dhcp-match=set:efi-x64,option:client-arch,7 dhcp-boot=tag:efi-x64,ipxe.efi,, enable-tftp tftp-root=/opt/tftproot
  4. Place boot images in /opt/tftproot/ and set appropriate read permissions for the dnsmasq daemon
  5. Boot from network and follow the installation instructions

Installation Process

Warning! This process will erase all data on /dev/sda!
  1. Select Alpine Linux OS in the boot menu (or press 1)
  2. Boot into the Live OS environment
  3. Log in as root (no password required)
  4. Verify the installation scripts: root# ls -1 /root setup-alpine-on-sda-unattended.sh setup-asteraid.sh setup-asterisk.sh
  5. Run the base installation: root# sh /root/setup-alpine-on-sda-unattended.sh The system will reboot automatically when completed
  6. Select Boot from hard drive in the boot menu (or wait 5 seconds)
  7. Boot into the installed OS
  8. Log in as root (no password required)
  9. Install Docker and Asteraid containers: root# sh /root/setup-asteraid.sh
  10. Verify containers up and runing root# docker ps
  11. (Optional - Only if you want to run Asteraid on the same system) Install Asterisk PBX: root# sh /root/setup-asterisk.sh

Post-Installation Steps

  • Set a root password for ssh access
  • Note the assigned IP address displayed on the console
  • Assign a permanent IP address if needed by editing /etc/network/interfaces
  • Access the web interface at https://[SERVER-IP] to complete the configuration