/durbin

Docker Container Monitor - watch your containers running on a remote server.

Primary LanguagePHPMIT LicenseMIT

Durbin - Docker Container Manager

Tiny PHP script for monitoring Docker Containers running on a VPS/remote server.

Durbin Screenshot

Installation Steps

  1. git clone git@github.com:ajaxray/durbin.git,
  2. composer install --prefer-dist
  3. Copy the inc/config.php.
cp inc/config.php inc/config.local.php

Then adjust your deployment environment in inc/config.local.php.

  1. Now you can run it like any php application using nginx, apache, or even with PHP development server1.
# Assuming you are in Durbin base directory
cd public
php -S localhost:8081

Durbin is built using Framework-X. See Production deployment options from their docs.

Running in a subdirectory

If your domain is example.com and you want to keep this tool at example.com/durbin, just keep this durbin directory in your example.com's web root directory.
Also, in the inc/config.php file, set base_url to 'http://example.com/durbin/'.

Security

Secured with Basic Auth by default. Check the auth values in inc/config.php to get/change the username and password.

If you want to disable it, just remove BasicAuthMiddleware from FrameworkX\App instantiation in index.php. Disabling auth is NOT RECOMMENDED! unless you are using some other kind of security.

Roadmap

  • Show running containers
  • Show all containers (including stopped)
  • Show container status (CPU/Memory uses etc.)
  • Secure with Basic Auth
  • Ability to install in subdirectory
  • Show latest logs of a container
  • Show streaming logs of a container
  • Start a stopped container
  • Stop a running container

Notes/Cautions

  1. PHP development server php -S is not suitable for showing streaming logs.

Additional things to remember

  • Docker should be in running state in your server.
  • This app itself should not be running inside Docker container.

Credits

  • Built using Framework-X, a modern PHP microframework on top of ReactPHP.
  • The background illustration was taken from here.
  • The logo was a free icon on iconfinder.com.