Sign inSign up

pottava/docker-webui

By pottava

•Updated about 9 years ago

A web interface of Docker remote APIs.

Image
11

1M+

pottava/docker-webui repository overview

⁠Docker Web-UI

Supported tags and respective Dockerfile links:
・latest (production/Dockerfile⁠)

⁠Description

A web user-interface for docker⁠.
(日本語はこちら⁠)

⁠Features

⁠handling docker containers
  • search containers (by status, labels, query strings)
  • inspect, top, stats, logs, diff, rename, commit
  • start, stop, restart, kill, rm
  • search its image

⁠tailing containers' logs
  • filter target containers by labels
  • monitoring logs (10~200 lines each) every specified seconds

⁠watch containers' statistics
  • filter target containers by labels
  • display CPU & memory on running containers by charts
  • details on the bottom table

⁠watch specified container's logs & stats
  • monitoring logs (10~200 lines each) every specified seconds
  • you can check CPUs & memorys at the same time

⁠handling docker images
  • search images (by labels, query strings)
  • docker pull a new image
  • docker pull the same image again
  • inspect, history, tag, rmi

⁠Usage

⁠1. Run the application

as a docker-compose service

monit:
  image: pottava/docker-webui
  ports:
    - "9000:9000"
  volumes:
    - "${DOCKER_CERT_PATH}:/etc/docker-compose/cert"
  environment:
    - DOCKER_HOST
    - DOCKER_CERT_PATH=/etc/docker-compose/cert
    - APP_LABEL_OVERRIDE_NAMES=com.docker.compose.service
    - APP_LABEL_FILTERS=com.docker.compose.service

or as a simple docker container

$ docker run -p 9000:9000 --rm -v /var/run/docker.sock:/var/run/docker.sock pottava/docker-webui
$ docker run -p 9000:9000 --rm -e DOCKER_HOST -e DOCKER_CERT_PATH=/etc/docker-compose/cert -v $DOCKER_CERT_PATH:/etc/docker-compose/cert pottava/docker-webui

or as a go binary

$ go get github.com/pottava/docker-webui
$ docker-webui

⁠2. Access to the following URL

http://localhost:9000/⁠

⁠Startup Options

You can set environment variables or use config.json⁠ to configure the application.

Option (config.json)Environment VariablesDescriptionDefault
NameAPP_NAMEname of this application'docker web-ui'
PortAPP_PORTport the app is listening on9000
　CONFIG_FILE_PATHpath of config.json'/etc/docker-webui/config.json'
ViewOnlyAPP_VIEW_ONLYif you set true, you cannot change docker statefalse
LogLevelAPP_LOG_LEVEL1:fatal, 2:err, 3:warn, 4:info, 5:debug, 6:trace4
LabelOverrideNamesAPP_LABEL_OVERRIDE_NAMESoverride containers name by its label value
LabelFiltersAPP_LABEL_FILTERSlabels for filtering containers & images['all']
DockerEndpointsDOCKER_HOSTdocker API endpoints (tcp or socket)[unix:///var/run/docker.sock]
DockerCertPathDOCKER_CERT_PATHset certifications' absolute path on the host['']
DockerPullBeginTimeoutDOCKER_PULL_BEGIN_TIMEOUTtimeout of docker pull to start3 * time.Minute
DockerPullTimeoutDOCKER_PULL_TIMEOUTtimeout of docker pull2 * time.Hour
DockerStatTimeoutDOCKER_STAT_TIMEOUTtimeout of docker stat5 * time.Second
DockerStartTimeoutDOCKER_START_TIMEOUTtimeout of docker start10 * time.Second
DockerStopTimeoutDOCKER_STOP_TIMEOUTtimeout of docker stop10 * time.Second
DockerRestartTimeoutDOCKER_RESTART_TIMEOUTtimeout of docker restart10 * time.Second
DockerKillTimeoutDOCKER_KILL_TIMEOUTtimeout of docker kill10 * time.Second
DockerRmTimeoutDOCKER_RM_TIMEOUTtimeout of docker rm5 * time.Minute
DockerCommitTimeoutDOCKER_COMMIT_TIMEOUTtimeout of docker commit30 * time.Second
StaticFileHostAPP_STATIC_FILE_HOSThost name which provides static files
StaticFilePathAPP_STATIC_FILE_PATHstatic file path on the host'$GOPATH + /src/github.com/pottava/docker-webui/app'
PathPrefixAPP_PATH_PREFIXURL Path prefix for path based routing
PreventSelfStopAPP_PREVENT_SELF_STOPprevent to stop this app itself if you set truetrue
HiddenContainersAPP_HIDDEN_CONTAINERShide specified containers if you like[]

⁠Contribution

  1. Fork (https://github.com/pottava/docker-webui/fork⁠)
  2. Create a feature branch
  3. Commit your changes
  4. Rebase your local changes against the master branch
  5. Create new Pull Request

⁠Copyright and license

Code released under the MIT license⁠.

Tag summary

Content type

Image

Digest

sha256:10864fbf7…

Size

6.8 MB

Last updated

about 9 years ago

docker pull pottava/docker-webui