docs: Clarify documentation of remote development environment.

This commit is contained in:
Tim Abbott 2018-03-13 09:44:17 -07:00
parent 4631a2bfc3
commit c7b560cdc2
1 changed files with 14 additions and 4 deletions

View File

@ -41,14 +41,19 @@ the remote virtual machine, we recommend installing
[Vagrant][install-vagrant] method so you can easily uninstall if you [Vagrant][install-vagrant] method so you can easily uninstall if you
need to. need to.
For a direct install, also set `EXTERNAL_HOST=<REMOTE_IP>:9991` in your The main difference from the standard instructions is that for a
environment. This allows you to access Zulip running in your development remote development environment, you'll need to run `export
environment using a browser on another host. EXTERNAL_HOST=<REMOTE_IP>:9991` in a shell before running `run-dev.py`
(and see also the `--interface=''` option documented below). If your
server has a static IP address, we recommend putting this command in
`~/.bashrc`, so you don't need to remember to run it every time. This
allows you to access Zulip running in your development environment
using a browser on another host.
## Running the development server ## Running the development server
Once you have set up the development environment, you can start up the Once you have set up the development environment, you can start up the
development instance of Zulip with the following command in the directory where development server with the following command in the directory where
you cloned Zulip: you cloned Zulip:
``` ```
@ -62,6 +67,11 @@ this screenshot of the Zulip development environment:
![Image of Zulip development ![Image of Zulip development
environment](../images/zulip-dev.png) environment](../images/zulip-dev.png)
The `--interface=''` command makes the Zulip development environment
accessible from any IP address (in contrast with the more secure
default of only being accessible from localhost, which is great for
developing on your laptop).
You can [port You can [port
forward](https://help.ubuntu.com/community/SSH/OpenSSH/PortForwarding) using forward](https://help.ubuntu.com/community/SSH/OpenSSH/PortForwarding) using
ssh instead of running the development environment on an exposed interface. ssh instead of running the development environment on an exposed interface.