Manual Install Guide

Please note that only Linux is supported. If you want to use Prax under Mac OS X, you'll be missing the port redirections (ports 80 -> 20559 and 443 -> 20558) and a DNS resolver. Contributions are welcomed!

1. Install dnsmasq, and configure it to resolve .dev domains to localhost:

local=/dev/
address=/dev/127.0.0.1
address=/dev/::1

Which you may install as /etc/NetworkManager/dnsmasq.d/prax or /etc/dnsmasq.d/prax depending on your system configuration.

2. Install the iptables rules:

$ sudo cp install/debian/initd /etc/init.d/prax
$ sudo update-rc.d prax defaults
$ sudo /etc/init.d/prax start

You'll may want/need an alternative script for non sysvinit init systems.

3. Either install the latest Crystal release, or clone and build the master branch.

4. Compile Prax:

$ make

You'll may want to specify the crystal binary to use:

$ make CRYSTAL_BIN=/path/to/crystal/bin/crystal

5. Prepare Prax environment:

$ mkdir ~/.prax

change directory to add symbolic links

$ cd /usr/local/bin 

$ sudo ln -s /path/to/prax/bin/prax    # Creates symbolic link so all users can use prax

6. Start Prax, and test that it works:

$ ./bin/prax start
$ firefox localhost

7. Link your applications, and enjoy:

$ cd path/to/myapp
$ prax link
$ firefox myapp.dev