slhoehn / docketeer

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

🏠 Homepage | 🗃 Repository | 🐛 Issue Tracker

🪑 Table of Content

• 🧰 Features
• 👶 Install
• 🚀 Usage
• 🛠 Developing
• 🧪 Testing
• 🧙 Contributors
• ⭐ Show your support
• 📝 License

🧰 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

• https://github.com/open-source-labs/Docketeer.git

2. CD into directory, then npm install
3. Configure the environment variables for Twilio API following the example below.
4. 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.

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.

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.

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.

Metrics

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

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.

🛠 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

• Dan Lin @GitHub @LinkedIn
• Kadir Gundogdu @GitHub @LinkedIn
• Minchan Jun @GitHub @LinkedIn
• Wilmer Sinchi @GitHub @LinkedIn
• Richie Edwards @GitHub @LinkedIn
• Mitesh Patel @GitHub @LinkedIn
• Matt Jones @GitHub @LinkedIn
• Chai Lee @GitHub @LinkedIn
• Anton Abdukhamidov @GitHub @LinkedIn

⭐ Show your support

Give a ⭐️ if this project helped you!

📝 LICENSE

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