Skip to content
Dashboard for the Onyx distributed processing system
Branch: 0.14.x
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.
.circleci Fix circleci 2 build issues. Jul 3, 2018
env runtime configure job management Feb 28, 2018
resources add logging, allow to see logs from included jars Sep 16, 2016
scripts Use Alpine Linux for Docker image Aug 31, 2016
src runtime configure job management Feb 28, 2018
test/onyx/peer Fix automated test Nov 27, 2018
.gitignore Prepare for release. Sep 20, 2015
Dockerfile ditch s6 and alpine, make docker take ZK as an arg Nov 15, 2016
LICENSE Initial commit. Jan 23, 2015
Procfile Initial commit. Jan 23, 2015 Note onyx-dashboard unmaintained. Nov 10, 2018
project.clj Initial commit. Jan 23, 2015



A dashboard for the Onyx distributed computation system.


Circle CI

Design and User Guide

A description and user guide disguised as a blog post can be found here.


Version numbers will be kept in sync with [Onyx] ( For example, to use a version compatible with Onyx, use a version of the dashboard beginning with The fourth version number will be reserved for dashboard versioning, in order to provide releases out of band with Onyx.

Releases are listed at


Run the jar via:

java -server -jar onyx-dashboard-VERSION.jar ZOOKEEPER_ADDR

By default the server will listen on port 3000, but this can be configured via the PORT environment variable.

Alternately, run the docker image like so:

docker run -p 3000:3000 onyx/onyx-dashboard:<tag>

The IP passed in is used by ZooKeeper.

NOTE: If you are running the Onyx Dashboard via Docker on Mac, but are running ZooKeeper locally, be aware that there are limitations with networking on Mac. Per the Docker on Mac networking documentation, your best work around is to assign a dummy IP as an alias to the loopback adapter on the host machine and point the Docker image at that IP. Something like this should do the trick:

sudo ifconfig lo0 alias
docker run -p 3000:3000 onyx/onyx-dashboard:latest


In a terminal start a sample job and cluster to dashboard against:

lein run -m onyx.peer.dag-test

Then start developyment:

Run lein repl to start your repl.

In the REPL, run


Then run:

(user/stop) ( (user/go "")

to start the server, and each time you make a change on the server.

Then point your browser at http://localhost:3000/


Copyright © 2016 Distributed Masonry

Distributed under the Eclipse Public License either version 1.0 or (at your option) any later version.


Created with Chestnut 0.7.0-SNAPSHOT (ecadc3ce).

You can’t perform that action at this time.