This reference for version: 1.3.0

Simple status page with UI updates by SSE, backed by constant polling of status handle of Selenoid on small go backend. Source code available at GitHub.

1. Quick Start Guide

1.1. You have Docker

  1. Start UI with one command:

    # docker run -d --name selenoid-ui --net host aerokube/selenoid-ui

  2. If you don’t want to use --net host or have no support (e.g. under MacOS) you need to determine your Docker host IP address. Then launch Selenoid UI like the following:

    # docker run -d --name selenoid-ui -p 8080:8080 aerokube/selenoid-ui -selenoid-uri http://<host-ip>:4444

1.2. You don’t have Docker

  1. Download Selenoid UI binary from releases page.

  2. Start it:

    $ ./selenoid-ui

  3. To connect to remote Selenoid just specify its URI:

    $ ./selenoid-ui -selenoid-uri http://<host-ip>:4444

2. Features list:

2.1. Stats

Shows current quota usage, pending browsers and queue. Gets updates via SSE, so no need to refresh browser to see what happens.

Stats and capabilities

ui

2.2. Capabilities

You can choose browser from the available browser list and UI will provide an example of setup with right capabilities. Examples available for several languages.

2.3. VNC

If you get browser from selenoid with enableVNC=true capability, you can see list of available screens:

VNC list

ui

VNC allows to see and interact with browser:

Exact VNC session

ui

Fullscreen mode

ui

Please refer to selenoid documentation about VNC usage.

2.4. LOGS

With same as VNC list you can see logs of docker container (no any additional action required)

Logs

logs

3. Contributing & Development

1) Ensure you have yarn and go-bindata-assetfs installed

  • For tests deps install go get -u github.com/aandryashin/matchers

2) Generate static resources:

$ go generate ./web ./...

3) Build:

$ go build

4) To build Docker container type:

$ GOOS=linux GOARCH=amd64 CGO_ENABLED=0 go build
$ docker build -t selenoid-ui:latest .

3.1. Documentation

Locally can be generated with:

$ docker run --rm -v `pwd`/docs/:/documents/      \
    asciidoctor/docker-asciidoctor                \
    asciidoctor -D /documents/output/ index.adoc