Asterisk@Home Handbook Wiki Chapter 0

Chapter 0 About the Project

Putting together an easy to use, self configured, works everytime (almost), asterisk PBX solution is not an easy task. It takes an awful lot of time and energy to successfully pull it off. If you find Asterisk@Home a worthy product, please go to our donations page and donate. Your support can help our developers continue putting out great releases.

0.1 Please Donate!!!

Please visit our donations page at and contribute. To view Asterisk@Home Supporters please visit

0.2 Project Manager

The Asterisk@Home Project Manager is Andrew. His alias at is Agillis.

0.3 Handbook & Documentation Editor

The Asterisk@Home's Handbook and Documentation Editor is Ginel Lipan. My alias at is GinelLipan. I'm a Network Admin at Kawasaki Rail Car, Inc. in Yonkers, NY. When I first stumbled onto A@H, I was completely floored. A@H is an amazing compilation of software that makes it more than the sum of its parts. Asterisk alone is highly configurable, but when you put it together into a package like Asterisk@Home did, it really goes above and beyond. Asterisk@Home has managed to deliver Asterisk to a swath of users that otherwise wouldn't of even dreamed of trying to use it (including me). Asterisk by itself tends to require a high level of command line and technical expertise. Luckily A@H covers much of the work (installing an OS, installing asterisk, installing a web based configuration tool (AMP), etc etc).

On top of it all I am grateful for the Open Source Community's time and effort that has benefited us all with extremely high quality software. Without a community of contributors, the world's options would have been severely limited. Now that the 3rd World is beginning to enter into the global IT economy, open source software and its development is really set to take off. So I've decided to give back to the community by trying to put together a high quality piece of documentation that both beginners and experts can gain from. I encourage everyone to contribute to this handbook so new users can learn from our pool of collective knowledge and experience. Comments and critiques are always welcome. If you'd like to send me an email, I can be reached at
. For any requests for help concerning A@H, please RTFM (Read This Fine Manual) or search our SourceForge forum. If there isn't anything in the Handbook or forum, please post your question in the forum. Next time anyone with the same problem searches the forum, they'll be able to find your question and hopefully an answer.

0.4 Handbook Wishlist (Please enter your requests here)

There are just too many facets to A@H for me to be able to know what needs to go into the handbook. Please put your Handbook wishlist here so the community can see what documentation needs there are.

      1. Finish the Shorewall Instructions (based on Samy Antoun instructions at and
      2. Work on seriously expanding the AMP instructions.
      3. Work on the SSH instructions
      4. See if IPCOP would make a better, easier to configure firewall solution than Shorewall and put up instructions on how to install it. IPCOP is really really easy and has a LOT of nice web based configuration pages.
      5. Open A2Billing Instructions and how it works
      6. Voicemail to email notification and Voicemail to email as an attachment setup instructions (so that a newbie can understand it).
      7. Anyway the voicemail to email attachment can be encoded as an MP3 instead of a wav? (smaller attachment)
      8. How to troubleshoot a problem using the software tools in AAH

0.5 The problem with writing/editing this Handbook.

The problem with writing/editing this handbook is that Asterisk@Home encompasses an incredible amount of different software packages. There is a wealth of information already on the net concerning each piece of software (CentOS, Asterisk, etc). Unfortunately, it would be to easy to just send users to external web sites and have them find the information they're looking for. But what happens when those links no longer work? That's why the editors of this handbook will do their best to concisely explain instructions and information even though it may be a repeat of information already offered elsewhere. The handbook may grow fairly large because of this but at least all the information will be in one place and not scattered around.

What it comes down to is the fact that you will be able to use this Handbook for a handful of other things that may have only a little to do with Asterisk@Home (example: Dynamic DNS information, using a DHCP server with CentOS, etc). I will do my best to make sure all the information you need to use Asterisk@Home is here in this handbook without having to send you to half a dozen other web sites to figure things out.

0.6 Everyone is encouraged to edit this Handbook.

This Handbook cannot exist without a community effort. If you see places in the handbook that needs editing for clarification or just adding additional information, don't hesitate to add it. This way the Handbook can gain from all of our experience and evolve into a great resource for everyone. This Handbook should be the FIRST thing users read when installing Asterisk@Home instead of searching around the net for bits and pieces of information and how-to's.

0.7 Liability Disclaimer

The authors/editors of this handbook are NOT responsible for any damage done to your system for following its instructions. Since this is a wiki, it has been edited by hundreds of people and the filtering out of mistakes is simply impossible. Do not follow this handbook blindly. Understand what is taking place and make an informed decision when messing around with your hardware/software.

Created by: GinelLipan, Last modification: Tue 20 of Sep, 2011 (23:44 UTC) by admin
Please update this page with new information, just login and click on the "Edit" or "Discussion" tab. Get a free login here: Register Thanks! - Find us on Google+