You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Go to file
Anthony Lapenna 06f54e300c
fix(ui): hidden containers (using label) are now removed from dashboard and swarm view (#46)
9 years ago
app fix(ui): hidden containers (using label) are now removed from dashboard and swarm view (#46) 9 years ago
assets feat(ui): new container creation view (#29) 9 years ago
examples/nginx-basic-auth Rdash theme integration (#1) 9 years ago
test/unit feat(ui): new containers view (#25) 9 years ago
.dockerignore Added docker-compose config for nginx-basic-auth. 9 years ago
.gitignore udate .gitignore 9 years ago
.godir Makes dockerui compatible with dokku 11 years ago
Dockerfile fix(binary): persist CSRF auth file in a volume (#22) 9 years ago
LICENSE update LICENSE 9 years ago
Procfile Makes dockerui compatible with dokku 11 years ago
README.md fix(flags): fix grunt run-swarm command and update long flag format (#26) 9 years ago
bower.json feat(ui): replace ViewSpinner with JQuery animations (#43) 9 years ago
dashboard.png update documentation/naming 9 years ago
dockerui.go chore(version): bump version number 9 years ago
gruntFile.js feat(ui): replace ViewSpinner with JQuery animations (#43) 9 years ago
index.html configuration is now exposed in /config endpoint (#13) 9 years ago
package.json chore(version): bump version number 9 years ago

README.md

Cloudinovasi UI for Docker

A fork of the amazing UI for Docker by Michael Crosby and Kevan Ahlquist (https://github.com/kevana/ui-for-docker) using the rdash-angular theme (https://github.com/rdash/rdash-angular).

Dashboard

UI For Docker is a web interface for the Docker Remote API. The goal is to provide a pure client side implementation so it is effortless to connect and manage docker.

Goals

  • Minimal dependencies - I really want to keep this project a pure html/js app.
  • Consistency - The web UI should be consistent with the commands found on the docker CLI.

Run

Quickstart

  1. Run: docker run -d -p 9000:9000 --privileged -v /var/run/docker.sock:/var/run/docker.sock cloudinovasi/cloudinovasi-ui

  2. Open your browser to http://<dockerd host ip>:9000

Bind mounting the Unix socket into the UI For Docker container is much more secure than exposing your docker daemon over TCP.

The --privileged flag is required for hosts using SELinux.

Specify socket to connect to Docker daemon

By default UI For Docker connects to the Docker daemon with/var/run/docker.sock. For this to work you need to bind mount the unix socket into the container with -v /var/run/docker.sock:/var/run/docker.sock.

You can use the -e flag to change this socket:

# Connect to a tcp socket:
$ docker run -d -p 9000:9000 cloudinovasi/cloudinovasi-ui -e http://127.0.0.1:2375

Swarm support

Supported Swarm version: 1.2.3

You can access a specific view for you Swarm cluster by defining the --swarm flag:

# Connect to a tcp socket and enable Swarm:
$ docker run -d -p 9000:9000 cloudinovasi/cloudinovasi-ui -e http://<SWARM_HOST>:<SWARM_PORT> --swarm

NOTE: Due to Swarm not exposing information in a machine readable way, the app is bound to a specific version of Swarm at the moment.

Change address/port UI For Docker is served on

UI For Docker listens on port 9000 by default. If you run UI For Docker inside a container then you can bind the container's internal port to any external address and port:

# Expose UI For Docker on 10.20.30.1:80
$ docker run -d -p 10.20.30.1:80:9000 --privileged -v /var/run/docker.sock:/var/run/docker.sock cloudinovasi/cloudinovasi-ui

Hide containers with specific labels

You can hide specific containers in the containers view by using the -hide-label or -l options and specifying a label.

For example, take a container started with the label owner=acme:

$ docker run -d --label owner=acme nginx

You can hide it in the view by starting the ui with:

$ docker run -d -p 9000:9000 --privileged -v /var/run/docker.sock:/var/run/docker.sock cloudinovasi/cloudinovasi-ui -l owner=acme

Available options

The following options are available for the ui-for-docker binary:

  • --endpoint, -e: Docker deamon endpoint (default: "/var/run/docker.sock")
  • --bind, -p: Address and port to serve UI For Docker (default: ":9000")
  • --data, -d: Path to the data folder (default: ".")
  • --assets, -a: Path to the assets (default: ".")
  • --swarm, -s: Swarm cluster support (default: false)
  • --hide-label, -l: Hide containers with a specific label in the UI