How to install relay
- Download and install ActivePython
- Open Command Prompt
pypm install relay
Meta-magical SSH tunnels for remote developers behind firewalls.
Ever tried to pair-program with someone who works behind a firewall? You want to SSH into their machine, but you can't! Relay makes it possible to share your development environemnt with anyone by using another server in the middle to proxy the connection. And it doesn't just work with SSH--you can tunnel the webserver too!
Relay requires that you have a server running somewhere public which you can use to bounce connections from between your users. We use an EC2 micro in a public security group, but you can use anything you want. You'll need to make sure whatever ports you map in your ports.json are open to the world.
Relay can be installed in a virtualenv, but we recommend installing it with sudo so it is always available:
(nprapps users see the next section)
Relay uses a configuration file located at ~/.relay.conf. Create this file with contents such as:
ports.json is a mapping of user's local ports to remote ports on the server, so that users will never collide when creating SSH tunnels. Create this file with contents such as:
bash_profile is totally optional, but could contain aliases or environment variables you want every user to have automatically available.
You now need to create a relay user. This process is automated:
If you're running OS X, you need to enable remote login for the newly created relay user. Open System Preferences and navigate to the "Sharing" preference pane.
Check the box next to "Remote Login." You can either add the relay user to the allowed users, or just leave it open to "All users."
Pre-baked configuration files are in our Dropbox folder. You must have Dropbox installed, syncing to ~/Dropbox and the nprapps shared folder synced to your local computer. Then run: