{"id":17913499,"url":"https://github.com/cnasikas/docker-toolkit","last_synced_at":"2026-01-21T20:33:59.043Z","repository":{"id":39322749,"uuid":"220654218","full_name":"cnasikas/docker-toolkit","owner":"cnasikas","description":"Manage docker containers and images from a graphical user interface.","archived":false,"fork":false,"pushed_at":"2023-01-04T13:01:08.000Z","size":2420,"stargazers_count":1,"open_issues_count":60,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2025-04-08T08:26:26.424Z","etag":null,"topics":["docker","docker-container","docker-image","docker-tool","nodejs","react","redux"],"latest_commit_sha":null,"homepage":"","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/cnasikas.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2019-11-09T14:29:48.000Z","updated_at":"2023-03-08T03:21:27.000Z","dependencies_parsed_at":"2023-02-02T13:17:22.819Z","dependency_job_id":null,"html_url":"https://github.com/cnasikas/docker-toolkit","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/cnasikas/docker-toolkit","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cnasikas%2Fdocker-toolkit","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cnasikas%2Fdocker-toolkit/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cnasikas%2Fdocker-toolkit/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cnasikas%2Fdocker-toolkit/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/cnasikas","download_url":"https://codeload.github.com/cnasikas/docker-toolkit/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/cnasikas%2Fdocker-toolkit/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28642020,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-21T18:04:35.752Z","status":"ssl_error","status_checked_at":"2026-01-21T18:03:55.054Z","response_time":86,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.6:443 state=error: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["docker","docker-container","docker-image","docker-tool","nodejs","react","redux"],"created_at":"2024-10-28T19:52:14.080Z","updated_at":"2026-01-21T20:33:54.035Z","avatar_url":"https://github.com/cnasikas.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"[![JavaScript Style Guide](https://cdn.rawgit.com/standard/standard/master/badge.svg)](https://github.com/standard/standard)\n\n# docker-toolkit\n\nManage docker containers and images from a graphical user interface.\n\n## Installation\n\n- `cd ./docker \u0026\u0026 yarn install`\n- In the `api` directory, copy `.env-template` to `.env`.\n- Add your docker host to the respective variable in `.env`. The docker host can be either `/var/run/docker.sock` or a url that follows the [URL Standard](https://nodejs.org/api/url.html#url_url_strings_and_url_objects).\n- `yarn install`\n- Start the server: `yarn start`\n- In the `app` directory, copy `.env-template` to `.env.development.local` for development or `.env.production.local` for production and modify the variables accordingly. See more at [create-react-app](https://facebook.github.io/create-react-app/docs/adding-custom-environment-variables#what-other-env-files-can-be-used).\n- `yarn install`\n- Start the app: `yarn start`\n\n## RESTful API\n\nThe RESTful API exposes the following routes:\n\n### List containers\n\nGet the details of all available containers.\n\n**URL** : `/api/container`\n\n**Method** : `GET`\n\n## Success Response\n\n**Code** : `200 OK`\n\n**Content** : `[{}]`\n\n**Content examples**\n\n```json\n[\n    {\n        \"id\": \"d4ab65c9306a\",\n        \"image\": \"httpd\",\n        \"state\": \"running\",\n        \"status\": \"Up 3 hours\"\n    },\n    {\n        \"id\": \"b55adb5daff1\",\n        \"image\": \"alpine\",\n        \"state\": \"exited\",\n        \"status\": \"Exited (0) 2 hours ago\"\n    },\n    {\n        \"id\": \"7ccba42e41cd\",\n        \"image\": \"ubuntu\",\n        \"state\": \"running\",\n        \"status\": \"Up 5 hours\"\n    }\n]\n```\n\n### Create container\n\nCreate a container.\n\n**URL** : `/api/container/create`\n\n**Method** : `POST`\n\n**Data example** All fields must be sent.\n\n```json\n{\n    \"image\": \"ubuntu\"\n}\n```\n\n#### Success Response\n\n**Code** : `200 OK`\n\n**Content** : `{}`\n\n### Start container\n\nStart container by id.\n\n**URL** : `/api/container/:id/start`\n\n**Method** : `POST`\n\n#### Success Response\n\n**Code** : `200 OK`\n\n**Content** : `{}`\n\n### Stop container\n\nStop container by id.\n\n**URL** : `/api/container/:id/stop`\n\n**Method** : `POST`\n\n#### Success Response\n\n**Code** : `200 OK`\n\n**Content** : `{}`\n\n### Delete container\n\nDelete container by id.\n\n**URL** : `/api/container/:id`\n\n**Method** : `DELETE`\n\n#### Success Response\n\n**Code** : `200 OK`\n\n**Content** : `{}`\n\nAll error responses follow [Docker Engine API](https://docs.docker.com/engine/api/v1.40/#tag/Container)\n\n## WebSocket API\n\nVarious operation of docker node such as container creation, image build, and container monitoring can take a lot of time. For that reason, a WebSocket Server is available where clients can connect, register to docker node streams, and interact with.\n\n**Warning**: Only [socket-io](https://socket.io/) clients are supported.\n\n### Messages\n\n**name**: `stats`\n\n**response**: Server responses container's stats to client.\n\n**Paylod example**\n\n```json\n{\n    \"cpu\": \"0.00%\",\n    \"id\": \"b55adb5daff1\",\n    \"mem_limit\": \"NaN KiB\",\n    \"mem_perc\": \"NaN%\",\n    \"mem_usage\": \"NaN kB\",\n    \"name\": \"bold_gates\",\n    \"net\": \"0 B / 0 B\"\n}\n```\n\n**name**: `log`\n\n**response**: Server responses container's log to client.\n\n**Paylod example**\n\n```json\n{\n    \"log\": \"/ # ls -la\"\n}\n```\n\n**name**: `output`\n\n**response**: Server responses output to client.\n\n**Paylod example**\n\n```json\n{\n    \"output\": \"Image successfully build!\"\n}\n```\n\n**name**: `attach-container`\n\n**request**: Client requests to be attached to a container for monitoring (stats \u0026 log).\n\n**Paylod example**\n\n```json\n{\n    \"id\": \"d4ab65c9306a\"\n}\n```\n\n**name**: `create-container`\n\n**request**: Client requests the creation of a container by image name.\n\n**Paylod example**\n\n```json\n{\n    \"image\": \"ubuntu\"\n}\n```\n\n**name**: `build-image`\n\n**request**: Client requests the building of an image by tar file.\n\n**Paylod example**\n\n```json\n{\n    \"image\": \"Buffer\",\n    \"tag\": \"my-image\"\n}\n```\n\n## CLI Usage\n\nThe CLI provides various functionalities to aid in the interaction with your docker node, without the need of API or APP deployment.\n\n### Usage\n\n```\nnode cli.js \u003ccommand\u003e\n\nCommands:\n  cli.js container \u003ccreate|start|stop|dele  Manage docker containers. Run cli.js\n  te|logs|stats|list\u003e [id]                  container --help for more\n                                            information.\n  cli.js image build \u003cfile\u003e                 Manage docker images. Run cli.js\n                                            image --help for more information.\n\nOptions:\n  --version  Show version number                                       [boolean]\n  --help     Show help                                                 [boolean]\n```\n\n### Examples\n\n```\nnode cli.js container list\nnode cli.js container create --image my_image_name\nnode cli.js container start 3ac79a9ced0c\nnode cli.js container logs 3ac79a9ced0c --stream\nnode cli.js container stats 3ac79a9ced0c --stream\nnode cli.js image build ./image.tar --image my_image_name\n```\n\n## TODO\n\n- Throttle stream when building an image or creating a container (Performance optimization).\n- More arguments on container creation and image build.\n- Dockerize toolkit.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcnasikas%2Fdocker-toolkit","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcnasikas%2Fdocker-toolkit","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcnasikas%2Fdocker-toolkit/lists"}