Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/zero4994/docker-management-dashboard
A management dashboard for your local docker containers
https://github.com/zero4994/docker-management-dashboard
Last synced: about 1 month ago
JSON representation
A management dashboard for your local docker containers
- Host: GitHub
- URL: https://github.com/zero4994/docker-management-dashboard
- Owner: zero4994
- Created: 2019-02-11T05:04:41.000Z (over 5 years ago)
- Default Branch: master
- Last Pushed: 2022-12-10T16:46:55.000Z (almost 2 years ago)
- Last Synced: 2024-05-29T19:23:59.166Z (4 months ago)
- Language: Vue
- Size: 8.63 MB
- Stars: 13
- Watchers: 3
- Forks: 3
- Open Issues: 25
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Docker Management Dashboard
A management dashboard for your local docker containers
## Overview
Docker Management Dashboard is an electron powered desktop application to manage your local docker containers in a friendly and interactive way without having to deal with the docker CLI.
It allows you to do the following operations:
#### Containers:
- Start
- Stop
- Pause
- Unpause
- Remove
- Inspect
- Get Logs
#### Volumes:
- Create
- Search
- Delete
- Prune
## Architecture
Its built using the following technologies:
- Vue JS
- Vuetify
- Node JS
- [Electron](https://electronjs.org/)
- [Docker](https://www.docker.com/)
- [Dockerode](https://github.com/apocas/dockerode.git)
## SetUp
To install and use head to the [releases](https://github.com/zero4994/docker-management-dashboard/releases) section and download the latest version. Note: The application is only currently available for MacOS.
If you want to build or contribute to this project:
Clone this repostitory
```bash
git clone https://github.com/zero4994/docker-management-dashboard.git
```
Execute yarn to initialize
```bash
yarn install
```
Serve the Application for local development
```bash
yarn serve
```
Build the application for installation
```bash
yarn electron:build
```
The output files can be found on /dist_electron folder
## Use
Once the application is installed the dashboard will launch as a desktop appliation.
### Containers
#### Starting Containers
The image screen can take a JSON Object as an input for the container's initial conditions. The definitions of the properties of the JSON Object can be found [here](https://docs.docker.com/engine/api/v1.37/#operation/ContainerCreate)
In case you have more than one tag of a certain repo (ex. Ubuntu 18.04 and Ubuntu 19.10) in your local machine this screen will display all tags for it in the Tags combo box, one has to be selected in order to start a container.
#### Managing Containers
The Docker Management Dashboard can perform basic operations to container "at glance"
When a container is expanded the screen will display the logs as default and also quick actions to perform
From the left menu inspection of the container is also available
### Volumes
The volumes screen will display all available volumes in your local machine
#### Create Volume
By selecting this option you will be asked for a name for that volume. Names must be in the format
```bash
[a-zA-Z0-9][a-zA-Z0-9_.-]
```
#### Delete Volume
By selecting the icon at the end of every volume you can delete it from you local machine. You will be prompted for confirmation. Note: You can only remove volumes that are not currently being used by a container.
#### Prune Volumes
By selecting the prune volumes option you can delete all the volumes in your local machine. Important: This option will remove all local volumes not used by at least one container.
## Contribution
Feel free to fork and contribute to this project