https://github.com/abduazizziyodov/docker-dashboard
🐳 Simple lightweight GUI application for working with Docker
https://github.com/abduazizziyodov/docker-dashboard
angular dashboard developer-tools docker docker-dashboard docker-desktop python rest-api rust starlette tauri typescript
Last synced: 24 days ago
JSON representation
🐳 Simple lightweight GUI application for working with Docker
- Host: GitHub
- URL: https://github.com/abduazizziyodov/docker-dashboard
- Owner: AbduazizZiyodov
- License: mit
- Created: 2022-05-22T12:53:35.000Z (almost 3 years ago)
- Default Branch: master
- Last Pushed: 2023-12-07T05:36:53.000Z (over 1 year ago)
- Last Synced: 2023-12-07T06:29:26.481Z (over 1 year ago)
- Topics: angular, dashboard, developer-tools, docker, docker-dashboard, docker-desktop, python, rest-api, rust, starlette, tauri, typescript
- Language: TypeScript
- Homepage:
- Size: 2.77 MB
- Stars: 21
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# 🐳 **Docker Dashboard**
> **_Simple lightweight GUI application for working with Docker!_**
## **📄 System Requirements**:
- Docker
- Operating system: `ubuntu` (tested `20.04 LTS`, `22.04 LTS`).
## **📦 Installation**
## **Server** 🚀
I changed the way of installing server-side components. You don't need to install anything on your local machine.
First, you need to pull the docker image:
> **Note**
> In this readme I used `tagname`, which you can find from releases section (e.g 2.4.0).
```sh
docker pull abduaziz/docker-dashboard:tagname
```
Now it is ready to run, but the docker-dashboard needs access to your local docker UNIX socket. Because it cannot get any data from your docker host, from inside of the container (it is an isolated environment). You have to pass your docker socket path through `-v`.
> **Note**
> You have to run the docker image on the `2121` port because the client-side application listens on this port. Port `9001` is for the supervisor `inet HTTP server`, it is optional but if you want, you can expose this port.
```sh
docker run -d -p 2121:2121 -p 9001:9001 \
-v /var/run/docker.sock:/var/run/docker.sock \
abduaziz/docker-dashboard:tagname
```
Visit http://localhost:2121 🎉
## **Client** 👨🦰
Go to the [releases](https://github.com/AbduazizZiyodov/docker-dashboard/releases). Download the latest version according to your operating system.
- **Ubuntu**
```sh
sudo dpkg -i docker-dashboard_*.deb
```
> **Warning**
> I uploaded `.dmg`, `.AppImage` packages also, you can test them. But they are not stable!
## **🔧 Development**
Clone this repository
```sh
$ git clone https://github.com/AbduazizZiyodov/docker-dashboard
```
**Running 🚀**
- `backend` (from src/):
```sh
make run
```
- `tests` (from parent dir)
```sh
# install test requirements from test_requirements.txt
$ make test
```
- `frontend` (from src/client)
```sh
npm start # or ng serve (global)
```
## **🏗️ Build**
First, you have to install some system dependencies,`rust` and `cargo`, then `tauri` itself. You can see all instructions from tauir's documentation.
**References**
- https://tauri.app/v1/guides/getting-started/prerequisites/
- https://tauri.app/v1/guides/getting-started/setup/integrate
- https://tauri.app/v1/guides/development/development-cycle
- https://doc.rust-lang.org/cargo/getting-started/installation.html
You can run client-side (preview) by this command:
```sh
cargo tauri dev
```
Build client-side. You should check `src/client/src-tauri/target` folder:
```sh
cargo tauri build
```
# **License**
This project is licensed under the terms of the MIT license.
Author: Abduaziz Ziyodov