This repo contains the Homebrew formulas I use for my Asterisk dev machine. This is pretty much a few packages which, for one reason or another, aren't the best fit for going into Homebrew itself.
xcode-select --install
brew tap leedm777/homebrew-asterisk
brew install asterisk
--with-clang
- Compile with clang instead of gcc- This is a new-ish option in Asterisk, and might be a bit crashy.
--with-dev-mode
- Enable dev mode in Asterisk- Disable optimizations, turns up build warnings, and enables the test framework.
--devel
- Install development version 13- Build the latest code from the 13 branch.
--HEAD
- Install HEAD version- Build the latest code from the master branch.
Configuration files are in /usr/local/etc/asterisk
. Detailed configuration
docs can be found on the Asterisk wiki.
If you have problems after an upgrade, it may be because of bad path information
that ended up in asterisk.conf
. Check that the directories section looks like:
[directories](!)
astetcdir => /usr/local/etc/asterisk
astmoddir => /usr/local/opt/asterisk/lib/asterisk/modules
astvarlibdir => /usr/local/var/lib/asterisk
astdbdir => /usr/local/var/lib/asterisk
astkeydir => /usr/local/var/lib/asterisk
astdatadir => /usr/local/var/lib/asterisk
astagidir => /usr/local/var/lib/asterisk/agi-bin
astspooldir => /usr/local/var/spool/asterisk
astrundir => /usr/local/var/run/asterisk
astlogdir => /usr/local/var/log/asterisk
astsbindir => /usr/local/opt/asterisk/sbin
If you want to just run Asterisk occasionally, just start it up using
/usr/local/sbin/asterisk -c
. It is recommended to not run Asterisk as root.
To have launchd start asterisk now and restart at login:
$ brew services start leedm777/asterisk/asterisk
To stop asterisk:
$ brew services stop leedm777/asterisk/asterisk
To reload asterisk after an upgrade:
$ brew services restart leedm777/asterisk/asterisk
To connect to Asterisk running as a service:
$ /usr/local/sbin/asterisk -r
To uninstall Asterisk, run brew rm asterisk
. To get rid of all local state and
configuration data:
$ rm -rf /usr/local/etc/asterisk /usr/local/var/lib/asterisk \
/usr/local/var/log/asterisk /usr/local/var/run/asterisk \
/usr/local/var/spool/asterisk
I used to have notes in the README for creating an asterisk
user for running
Asterisk. This is not very homebrew-y, so I dropped it.
I also had a custom plist that I recommended instead of homebrew's built-in
plist feature. If you had followed those instructions, you may need to remove
/Library/LaunchDaemons/org.asterisk.asterisk.plist
before installing
[the new plist above](#Running as a service).
Compilation fails with error: /usr/lib/bundle1.o: No such file or directory
This happens when you try to build Asterisk without the XCode CLT installed. This also affects how GCC is built, so you will also want to reinstall GCC. The good news is that with the CLT installed, GCC should install via bottle, which is tons faster than building it from source.
xcode-select --install
brew rm gcc
brew install asterisk
Configure fails with The Asterisk menuselect tool requires the 'libxml2' development package.
This happens because of a bug with Xcode 8 on OSX 10.11 (El Capitan). Right now, the only solution is to upgrade to macOS 10.12 (Sierra), downgrade to Xcode 7.3, or do some pretty terrifying edits to your system libraries.