Metadata-Version: 2.1
Name: cylc-uiserver
Version: 0.1
Summary: Cylc UI Server
Home-page: https://github.com/cylc/cylc-uiserver/
License: GPL
Platform: any
Description-Content-Type: text/markdown
Requires-Dist: jupyterhub (==1.0.*)
Requires-Dist: tornado (==6.0.*)
Requires-Dist: graphene-tornado (==2.1.*)
Requires-Dist: cylc-flow (==8.0a1)
Provides-Extra: all
Requires-Dist: jupyterhub (==1.0.*) ; extra == 'all'
Requires-Dist: tornado (==6.0.*) ; extra == 'all'
Requires-Dist: graphene-tornado (==2.1.*) ; extra == 'all'
Requires-Dist: cylc-flow (==8.0a1) ; extra == 'all'
Requires-Dist: pytest (==4.4.*) ; extra == 'all'
Requires-Dist: coverage (==4.5.*) ; extra == 'all'
Requires-Dist: pytest-cov (==2.6.*) ; extra == 'all'
Provides-Extra: tests
Requires-Dist: pytest (==4.4.*) ; extra == 'tests'
Requires-Dist: coverage (==4.5.*) ; extra == 'tests'
Requires-Dist: pytest-cov (==2.6.*) ; extra == 'tests'

[![Build Status](https://travis-ci.org/cylc/cylc-uiserver.svg?branch=master)](https://travis-ci.org/cylc/cylc-uiserver)
[![codecov](https://codecov.io/gh/cylc/cylc-uiserver/branch/master/graph/badge.svg)](https://codecov.io/gh/cylc/cylc-uiserver)

# Cylc UI Server

This project contains the Cylc UI Server. A JupyterHub-compatible application,
used to display the Cylc UI (or simply UI) to users, and to communicate with
Workflow Services (WFS).

## Installation

To install the production version, run:

- `pip install cylc-uiserver`

And for the development version, run the following from a clone of the project
git repository.

- `pip install -e .`

Once that is done, the Hub can be started with `jupyterhub`.
The default URL is [http://localhost:8000](http://localhost:8000).

### Starting multiple instances of jupyterhub

If you need to run multiple instances of `jupyterhub`, you will have to follow
the steps described below:

- copy `jupyterhub_config.py` to a different location
- change the following settings (change the ports to your environment):
    * `c.JupyterHub.bind_url = 'http://:7000'`
    * `c.JupyterHub.hub_bind_url = 'http://127.0.0.1:7878'`
    * `c.JupyterHub.proxy_api_port = 9001`
- finally start `jupyterhub` using that configuration file



