add details on env var / port allocation to the docs