NOTE:  0.6.1 release files have an astlinux-XX-DEV.img.gz file.  That file contains a disk image including the XX version of Astlinux within the runnix structure.

Follow these steps to install Astlinux 0.5 or later to a compact flash or hard drive.  If you want, you can try Astlinux by using a bootable CD.  If using a bootable CD, you can skip the runnix install step and start with step 2 after placing the CD in your drive.

1).  Install runnix using these instructions http://www.astlinux.org/node/28

2).  Copy Astlinux image files into the 'os' directory on the newly prepared CF card. For example, if the release is 0.6.0, the files will be distributed as astlinux-0.6.0-<ARCH>.tar.gz (paired with an sha1sum file). 

tar -xzvf astlinux-0.6.0-<ARCH>.tar.gz

cd astlinux-0.6.0-<ARCH>; cp * /path/to/os  

The nice thing is this part can be done on Windows.  The image files are stored on a vfat partition.  You can use physdiskwrite (which can be found on the m0n0wall website) to install the initial runnix image.

3).  Boot your system.  The default login for the root user is astlinux

4).  Create a new partition to use for writable storage.  The recommended method for a single CF install is to use UnionFS as documented on here http://www.astlinux.org/node/30 .  Alternatively, you can use a unionfs overlay and the historical 'key disk'.  If you don't use a key disk, the same file structure is created on the UnionFS partition.

5).  After running the genunion command reboot your system.

6).  After rebooting, please change your root password

7).  Verify that the unionfs structure is working correctly by rebooting and logging in with the new password.

You can now start using your Astlinux system.  If you are just starting out, it may be best to use the web interface to manage most of the settings.  Starting with Astlinux 0.6 we have chosen to include a new web interface for general management and the Asterisk-GUI interface from Digium.  The new web interface was written by Lonnie Abelbeck. Astlinux utilizes a file called rc.conf to hold many of the system settings. 

The /etc/rc.conf file is generated at boot or by issuing the gen-rc-conf command.  The source of the information is either /mnt/kd/rc.conf OR by parsing files in the /mnt/kd/rc.conf.d/ directory.  If the directory exists, those settings take precedence over the single rc.conf file.  Files in this directory which end in .conf are parsed in alphabetical order.  The result is written to /tmp/etc/rc.conf.  /etc/rc.conf is a symbolic link to this file.  Don't edit either of these files!  There is a warning on the top of each file which specifically gives this warning.  Edit the files in /mnt/kd/rc.conf or in the directory /mnt/kd/rc.conf.d instead.  

Specific information about using the new web interface can be found here:  http://lonnie.abelbeck.com/astlinux/info/webgui.php 

Information about the Asterisk-GUI can be found ???