/Docketeer

An easy-to-use GUI for Docker that allows developers to manage Docker containers and monitor crucial metrics.

Primary LanguageJavaScriptMIT LicenseMIT

logo

๐Ÿ  Homepage | ๐Ÿ—ƒ Repository | ๐Ÿ› Issue Tracker

๐Ÿช‘ Table of Content

๐Ÿงฐ Features

Managing Docker images, containers and networks from the command line while also trying to monitor crucial metrics can be tedious and counterintuitive. To make this process more developer-friendly, we created Docketeer: a GUI for Docker.

๐Ÿ‘ถ Install

  1. Clone repo
  1. CD into directory, then npm install
  2. Configure the environment variables for Twilio API following the example below.
  3. npm run dev

Twilio setup

1. Download the helper library from https://www.twilio.com/docs/node/install
2. In order to manage Twilio SMS notifications follow the step plan : https://www.twilio.com/docs/notify/quickstart/sms#messagingservice
3. Store your (i) Twilio number, (ii) Account Sid, (iii) Auth Token from twilio.com/console, (iv) SERVICE_SID, (v) verification service SID in a newly created .env file in the Docketeer folder in the following format:

 MY_PHONE_NUMBER='your mobile number'
 TWILIO_ACCOUNT_SID='code from your console'
 TWILIO_AUTH_TOKEN='token from your console'
 SERVICE_SID='code from notify service instance'
 VERIFICATION_SERVICE_SID='code from verify service instance'

4. Verification service was created here: https://www.twilio.com/console/verify/services code length and serviceSID can be taken from your Twilio account console.
5. All historical messages from the Twilio account can be found here: https://www.twilio.com/console/sms/logs

๐Ÿš€ Basic usage

Settings

On the settings page you can set up container specific sms notifications along with notification rules and connect containers to specific github repositories.

compose

Running Containers

Once you open the app, you will be able to see any containers that are already running. You can stop or see more details about any container with the click of a button. You can also run a container based on the id or repo of an image from the top-right.

running

Exited Containers

On the Exited Containers tab, you can view the containers that exited or were stopped. You can click to re-run or remove any exited container.

exited

Images

On the Images tab, you can view the images that are available for you locally. You can click to run or remove any image and you can also pull images from DockerHub by providing repo:version and clicking pull on the top-right.

images

Metrics

On the Metrics tab, you can view the total amount of resources that your containers are currently using.

metrics

Docker Compose

On the Docker Compose tab, you can drag and drop or upload a docker-compose.yml file to run multi-container applications and view your separate networks.

compose

๐Ÿ›  Development

All ideas and contributions to the project are welcome. To run the app in development mode, clone our repo to your local machine and execute the following commands:

npm install
npm run dev

๐Ÿงช Testing

To conduct tests on the codebase, clone our repo to your local machine and execute the following commands in the terminal:

npm install
npm run test

๐Ÿง™ Contributors

โญ Show your support

Give a โญ๏ธ if this project helped you!

๐Ÿ“ LICENSE

Distributed under the MIT License. See LICENSE for more information.