A Local Rack runs apps on your computer. This makes it easy to build and run apps for development purposes.
To install a local Rack you’ll first need to install Docker. The free Docker Community Edition can be found for your OS here.
Once you have Docker up and running you can use
cx to install a local Rack:
$ sudo cx rack install local pulling: convox/praxis:20170720082526 installing: /Library/LaunchDaemons/convox.rack.plist installing: /Library/LaunchDaemons/convox.router.plist
This starts the Convox API on your computer, which the
cx tool interacts with to manage apps.
Installing the Rack also starts a Convox Router on your computer. The router provides local DNS for the
*.convox hostname, and offers an HTTPS endpoint for every app. The result is development-friendly hostnames like
https://web.docs.convox for apps running on your laptops.
To eliminate a browser SSL security warning, you need to install the Convox Certificate Authority (CA) that the router users. This certificated is generated at install time, so the private key is unique to your computer. You can load this into your keychain with:
$ sudo security add-trusted-cert -d -r trustRoot -k /Library/Keychains/System.keychain /etc/convox/ca.crt
You can verify or revoke this certificate by searching for “convox” in the OS X Keychain.