Skip to content

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

License

Notifications You must be signed in to change notification settings

promagen/Docketeer

Β 
Β 

Repository files navigation

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.

About

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

Resources

License

Code of conduct

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 88.0%
  • CSS 11.8%
  • Shell 0.2%