ray/doc/install-on-ubuntu.md
Robert Nishihara cb7f6ca9b5 Attempt to start web UI when starting Ray. (#269)
* Attempt to start web UI when starting Ray.

* Add instructions for using web UI to cluster documentation.

* Don't check if port 8080 is open.

* Remove print statement.
2017-02-12 15:17:58 -08:00

1.5 KiB

Installation on Ubuntu

Ray should work with Python 2 and Python 3. We have tested Ray on Ubuntu 14.04 and Ubuntu 16.04

Dependencies

To install Ray, first install the following dependencies. We recommend using Anaconda.

sudo apt-get update
sudo apt-get install -y cmake build-essential autoconf curl libtool libboost-all-dev unzip python-dev python-pip  # If you're using Anaconda, then python-dev and python-pip are unnecessary.

pip install numpy cloudpickle funcsigs colorama psutil redis

If you are using Anaconda, you may also need to run the following.

conda install libgcc

Install Ray

Ray can be built from the repository as follows.

git clone https://github.com/ray-project/ray.git
cd ray/python
python setup.py install --user

Test if the installation succeeded

To test if the installation was successful, try running some tests. This assumes that you've cloned the git repository.

python test/runtest.py

Optional - web UI

Ray's web UI requires Python 3. To enable the web UI to work, install these Python packages.

pip install aioredis asyncio websockets

Then install polymer, which also requires Node.js and Bower.

Once you've installed Polymer, run the following.

cd ray/webui
bower install

Then while Ray is running, you should be able to view the web UI at http://localhost:8080.