Skip to content
scope2229 edited this page Sep 21, 2019 · 2 revisions

Prax relies on different system configuration to operate correctly.

Step 1: DNS

After installation, please check that you can resolve any .dev domain as expected. This can be done in command line, using getent. Warning: host and dig use DNS resolvers directly and won't go throught the NSSwitch extensions.

$ getent hosts circles.dev
::1             circles.dev

Please note that the application doesn't have to exist for this step to succeed. Instead of ::1 you'll may see localhost instead.

Step 2: Port Redirections

You'll may also want to try reaching Prax directly at port 20559:

$ curl -vv http://circles.dev:20559/

If this succeeds, you'll may have a problem with the iptables rules that redirect the traffic from ports 80 and 443 to 20559 and 20558. Please check that the rules have been correctly set. This is what I get on my Ubuntu 14.04 Linux with a single wlan0 device (some rules may duplicated if you have multiple eth/wlan devices):

$ sudo /etc/init.d/prax status
Chain OUTPUT (policy ACCEPT)
num  target     prot opt source               destination         
1    REDIRECT   tcp  --  0.0.0.0/0            127.0.0.1            tcp dpt:80 redir ports 20559
2    REDIRECT   tcp  --  0.0.0.0/0            127.0.0.1            tcp dpt:443 redir ports 20558
Chain PREROUTING (policy ACCEPT)
num  target     prot opt source               destination         
1    REDIRECT   tcp  --  0.0.0.0/0            0.0.0.0/0            tcp dpt:80 redir ports 20559
2    REDIRECT   tcp  --  0.0.0.0/0            0.0.0.0/0            tcp dpt:443 redir ports 20558
Chain OUTPUT (policy ACCEPT)
num  target     prot opt source               destination         
1    REDIRECT   tcp      ::/0                 ::1                  tcp dpt:80 redir ports 20559
2    REDIRECT   tcp      ::/0                 ::1                  tcp dpt:443 redir ports 20558
Chain PREROUTING (policy ACCEPT)
num  target     prot opt source               destination         
1    REDIRECT   tcp      ::/0                 ::/0                 tcp dpt:80 redir ports 20559
2    REDIRECT   tcp      ::/0                 ::/0                 tcp dpt:443 redir ports 20558

Step 3: OPENSSL

If your openSSL version is 1.1.1 or you are experiencing errors with prax certificate you need to change the file prax/libexec/prax-certificate

LINE 23 --- openssl req -new -key "$ssl_path/server.key" -out "$ssl_path/server.csr" -subj "/C=/ST=/L=/O=Prax Dev Cert/OU=/CN=localhost" --- Add your Country code, STate, Locality, OrganisationUnit. If you don't want to add these replace the line with the below line

openssl req -new -key "$ssl_path/server.key" -out "$ssl_path/server.csr" -subj "/O=Prax Dev Cert/CN=localhost"

save re-run prax certificate and the errors will be gone.

Clone this wiki locally