New Installation

Starting with AstLinux 1.2.5 installation images are now contained within an ISO Installer Image (astlinux-xxx-board.iso) for each board type. The ISO image can be used in several ways:

  • Write the ISO Installer image to a USB flash drive (dd image mode), then boot using the USB drive and install to an internal disk.
  • Boot the ISO Installer image (ISO CDROM) within a Virtual Machine and install to a virtual disk.
  • Mount the ISO Installer image and manually extract the desired .img.gz file from the “os” directory, gunzip and dd to a destination disk.

Typical New Installation:

  1. Download the appropriate astlinux-xxx-board.iso image from the AstLinux website. 1)
  2. Transfer the ISO image to a USB flash drive:
    • On Linux or *BSD use dd to transfer the image, where sdX is your USB flash drive
      $ dd if=astlinux-xxx-board.iso of=/dev/sdX
    • On Windows boxes, use Rufus (“Write in DD Image mode”).
    • On Mac OS X boxes, use os-x-cf-write.
    • On Chrome OS boxes, use chromeos-ssd-write.
  3. Boot using the USB flash drive, follow the menu to install to an internal disk.
    • Note → Serial console ISO images (-serial.iso) use serial settings of 19200n8.
  4. Shutdown, remove the USB flash drive and boot your new AstLinux system.
  5. Continue with the setup instructions below…

Persistent Storage Options (GUI)

AstLinux requires persistent storage, that file storage is of two classifications:

  • System overlay data (Unionfs), such as passwords, startup modules and other changes to the root system.
  • Configuration data (/mnt/kd/), such as the Asterisk configuration files, system settings and voicemail messages.

Using a single partition combining Unionfs data and /mnt/kd/ data is the default for new installations. Optionally, you may specify in the installation setup to create separate Unionfs and /mnt/kd/ partitions, resulting in two partitions for persistent storage.

Using a computer on the same network, open your favorite web browser and type the following…


Tip → Replace “pbx.local” with the IP address of your box if zero-configuration Bonjour is not supported in your browser.

Tip → Be sure that you use https (http will NOT work).

You will be prompted to login. The default user is admin with a password of astlinux


Now you will see the following screen:


Here you can choose how you want to configure your persistent storage. The drop-down box shows the proposed installation device. Read the instructions carefully and follow what it says.

Then click Continue, the screen below will be displayed.


The “System is Rebooting…” will disappear when the reboot is complete, then click Finish, after a short delay the system will reboot once again.

Note → Since reboot times can vary, your browser may fail to automatically reload, don't worry, wait a minute and manually reload your browser to continue.

Normally you will not see the screen below, your browser should be redirected to the Status page, but if you reload the browser to /admin/setup.php after a successful installation, you will see the screen below. If so, click Continue, to view the Status page.

Setup Final

You can confirm that the setup was successful by accessing the default status page:


Tip → Replace “pbx.local” with the IP address of your box if zero-configuration Bonjour is not supported in your browser.

You will get the following screen. (This is only part of the full screen.)


  • The /dev/sda1 partition is your original FAT16 data created by installing the astlinux-XXX.img .
  • The /dev/sda2 partition is…
    • By default, the combined Unionfs and /mnt/kd/ partition.
    • Or, only the Unionfs partition if you selected separate partitions.
  • The /dev/sda3 partition is for /mnt/kd/ data if you selected separate partitions.

Skip to Security and Sound Files when completed.

Persistent Storage Options (CLI)

The same procedure as above can also be done on the command line, e.g. when your NIC isn't working right from the start (/dev/sda is an example, it can be different on your box):

$ initial-setup status
ok-format /dev/sda

$ initial-setup format combined /dev/sda  (or for a separate partition: format separate /dev/sda 256)

$ reboot

$ initial-setup configure /dev/sda

$ reboot

Security and Sound Files

Using the web interface, click on the System Tab
and change the “admin” password.

Change Password

after which you will be asked to login with your new password.

Continue in the System tab to the Asterisk Sounds Packages section.

Asterisk Sounds

Select the package values (ex. core-english-ulaw), then select the action (ex. Upgrade/Install), then click on the Sounds Package button to perform the action. Usually a 'core' and 'moh' sound package using your native codec is all that is necessary, or at least a good start.

Tip → The default “Sounds Pkg URL” currently supports English, Spanish and French. But you can set a different “Sounds Pkg URL” in the Prefs Tab at “System & Staff Tab Options” to install other (or your own) sounds.

Optional Hardware Tweaks

While the AstLinux project is not in the business of recommending x86 hardware, we do occasionally privately purchase or have hardware donated to test with the AstLinux platform.

When focusing on a specific x86 board or appliance, often useful configurations and tweaks can be performed to optimize the hardware for use with AstLinux. The link below will take you to a list of tested hardware with configuration recommendations and photos.

Specific Tested Hardware: Generic x86 Boards and Appliances

Tip → Even if your exact hardware is not in the list, if you find a listing with a matching processor and chipset it may still be useful.

1) Various ISO images are available, built for specific hardware. If you are unsure which to download, for 32-bit use the astlinux-xxx-geni586.iso image, for 64-bit use the astlinux-xxx-genx86_64.iso image.