English
Download ISOISO
Asteraid Netinstall ISO v1.0

Deploy the system.
Your way.

A minimal network-install image for the Asteraid management system — provisioned on bare metal, a hypervisor, or Docker. Pick a path, follow the steps, you're live.

Download ISO Jump to install
Footprint16 GB · 2 GB RAM
Methods5 paths
Base OSAlpine Linux
Updated2026-03-20
01
Overview

Introduction

The Asteraid netinstall ISO is a minimal installation image for network-based deployment of the Asteraid management system. It downloads packages on demand, keeping the base image small while always provisioning the latest components.

02
Specs

Hardware Requirements

ComponentPhysical ServerVirtual Machine
CPU1 CPU (Intel/AMD x86_64)1 vCPU x86_64
Memory2GB minimum2GB minimum
Storage (OS with Docker images and containers only. For user data — backups, audio recordings, CDRs, etc. — use separate disks.)16GB minimum16GB minimum
Network1Gb Ethernet adapter (Wi-Fi not supported)Ethernet adapter in bridge mode (NAT not recommended)
Boot ModeBIOS or UEFIBIOS compatible
Note: These are minimum requirements. Production environments typically require more resources. 2 CPU cores and 8 GB of RAM should be sufficient in most cases.
03
Connectivity

Network Requirements

Stable Internet ConnectionMinimum 5 Mbps recommended.
DHCP NetworkAutomatic IP configuration is required.
Firewall AccessHTTP/HTTPS access to Asteraid repositories must be allowed.
Proxy ConfigurationConfigure proxy settings if behind a corporate proxy.
04
Choose a path

Installation Methods

Import a ready-made VM image, boot from removable or network media, or deploy directly with Docker.

Import OVA image

  1. Download OVA container
  2. Import the container into your hypervisor. Proxmox 6+ and 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 the post-installation steps.

Import Hyper-V image

  1. Download Hyper-V archive
  2. Unzip to a new empty folder. Import the content into your hypervisor. Hyper-V Manager 10+ is 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 the post-installation steps.

USB / DVD Installation

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

PXE Network Boot

  1. BIOS PXE image  UEFI PXE image
  2. Example DHCP configuration (Dnsmasq):
    dnsmasq.conf
    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
  3. Place the boot images in /opt/tftproot/ and set appropriate read permissions for the dnsmasq daemon.
  4. Boot from the network and follow the installation instructions.

Deploy Docker Images

  1. Pull the images, then build and run the Docker containers on an existing Docker host:
    bash
    $ git clone https://gitlab.com/plentystars/asteraid-docker-carrier.git
$ cd asteraid-docker-carrier
$ sudo docker compose build --progress=plain
$ sudo docker compose up -d
$ docker ps
  2. For debugging, rebuilding and maintenance, see the README.md.
05
Step by step

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@live
    # ls -1 /root
setup-alpine-on-sda-unattended.sh
setup-asteraid.sh
setup-asterisk.sh
  5. Run the base installation. The system will reboot automatically when completed:
    root@live
    # sh /root/setup-alpine-on-sda-unattended.sh
  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 the Asteraid containers:
    root@host
    # sh /root/setup-asteraid.sh
  10. Verify the containers are up and running:
    root@host
    $ docker ps
  11. (Optional — only if you want to run Asterisk on the same system) Install the Asterisk PBX:
    root@host
    # sh /root/setup-asterisk.sh
06
Finish up

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.