{"id":24077506,"url":"https://github.com/vulcanshen/docker-compose-convenience-script","last_synced_at":"2026-05-19T04:04:23.645Z","repository":{"id":269149326,"uuid":"906569420","full_name":"vulcanshen/docker-compose-convenience-script","owner":"vulcanshen","description":"dcp.sh is a shell script designed to streamline your Docker Compose workflow by simplifying common commands and offering several convenient features:","archived":false,"fork":false,"pushed_at":"2025-03-18T07:10:20.000Z","size":16,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-18T07:39:57.590Z","etag":null,"topics":["docker-compose","reload","shell"],"latest_commit_sha":null,"homepage":"","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/vulcanshen.png","metadata":{"files":{"readme":"readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-12-21T09:11:36.000Z","updated_at":"2025-03-18T07:10:23.000Z","dependencies_parsed_at":"2024-12-21T10:23:59.440Z","dependency_job_id":"4c4b65f6-39e9-4891-911b-4a36b8fb4b5a","html_url":"https://github.com/vulcanshen/docker-compose-convenience-script","commit_stats":null,"previous_names":["vulcanshen/docker-compose-convenience-script"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/vulcanshen/docker-compose-convenience-script","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vulcanshen%2Fdocker-compose-convenience-script","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vulcanshen%2Fdocker-compose-convenience-script/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vulcanshen%2Fdocker-compose-convenience-script/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vulcanshen%2Fdocker-compose-convenience-script/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/vulcanshen","download_url":"https://codeload.github.com/vulcanshen/docker-compose-convenience-script/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/vulcanshen%2Fdocker-compose-convenience-script/sbom","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":268692724,"owners_count":24291462,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-08-04T02:00:09.867Z","response_time":79,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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-compose","reload","shell"],"created_at":"2025-01-09T20:55:06.166Z","updated_at":"2026-05-19T04:04:18.581Z","avatar_url":"https://github.com/vulcanshen.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Docker Compose Convenience Script (dcp.sh)\n\n`dcp.sh` is a shell script designed to streamline your Docker Compose workflow by simplifying common commands and offering several convenient features:\n\n- **Quick reload**: Effortlessly update your Dockerized application's configuration with `dcp reload`. This command seamlessly stops and restarts all services, ensuring the latest changes in your docker-compose.yml file are immediately reflected.\n- **Alias functionality**: Use `dcp` as a handy alias for docker-compose, saving you time and keystrokes.\n- **Default plugin mode**: Enjoy a more streamlined experience with the default plugin mode.\n- **Standalone mode support**: If you're using the standalone docker-compose command, simply set the **COMPOSE_CMD** environment variable.\n\n# Installation\n\n## Install as shell function\n\n```sh\ngit clone https://github.com/vulcanshen/docker-compose-convenience-script.git ~/.dcp\necho \"source ~/.dcp/dcp.sh\" \u003e\u003e ~/.bashrc\nsource ~/.dcp/dcp.sh\n```\n\n## Install as command\n\n```sh\ngit clone https://github.com/vulcanshen/docker-compose-convenience-script.git dcp\nsudo mv dcp/dcp-cmd /usr/local/bin/dcp\nsudo chmod 755 /usr/local/bin/dcp\n```\n\n## Quick Install\n\n```sh\nsudo curl -sL https://raw.githubusercontent.com/vulcanshen/docker-compose-convenience-script/refs/heads/main/dcp-cmd \u003e /usr/local/bin/dcp\nsudo chmod 755 /usr/local/bin/dcp\n```\n\n# Usage\n\n## As a Docker Compose alias\n\nAfter installation, you can leverage dcp directly in place of docker-compose. Here are some examples:\n\n```sh\n# List all services\ndcp ps\n\n# Start all services in detached mode\ndcp up -d\n\n# Shutdown all services\ndcp down\n```\n\n## Standalone Docker Compose mode\n\nIf you're using the standalone docker-compose command, set the **COMPOSE_CMD** environment variable before using dcp.sh:\n\n```sh\nexport COMPOSE_CMD=\"docker-compose\"\n```\n\n## Quick reload\n\nThe `dcp reload` command simplifies updating your Docker Compose configuration. \nIt automates the process of stopping and restarting all services, \nensuring that any modifications you make to your docker-compose.yml file are promptly reflected \nin your running containers.\n\n**How it works**\n\n1. `dcp reload` gracefully stops all currently running services using docker-compose down.\n2. It then initiates `docker-compose up` to restart them based on the latest configuration defined in your docker-compose.yml file.\n\n**Usage examples**\n\n- Basic reload (equivalent to `docker-compose down \u0026\u0026 docker-compose up`):\n\n    ```sh\n    dcp reload\n    ```\n\n- Reload in detached mode (equivalent to `docker-compose down \u0026\u0026 docker-compose up -d`):\n\n    ```sh\n    dcp reload -d\n    ```\n\n- Reload with a custom YAML file (equivalent to `docker-compose down \u0026\u0026 docker-compose -f xxx.yaml up`):\n\n    ```sh\n    dcp -f xxx.yaml reload\n    ```\n\n- Reload with a custom YAML file in detached mode (equivalent to `docker-compose down \u0026\u0026 docker-compose -f xxx.yaml up -d`):\n\n    ```sh\n    dcp -f xxx.yaml reload -d\n    ```\n\n# Additional Features\n\n- Supports all Docker Compose commands: dcp.sh seamlessly integrates with all existing docker-compose commands.\n- Custom commands: Feel free to add custom Docker Compose commands to the script for further personalization.\n\n# Notes\n\n- Ensure Docker and Docker Compose are correctly installed in your environment.\n- If you encounter issues with plugin mode, try switching to standalone mode.\n- Carefully review the script content before deploying it to a production environment to ensure security.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvulcanshen%2Fdocker-compose-convenience-script","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvulcanshen%2Fdocker-compose-convenience-script","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvulcanshen%2Fdocker-compose-convenience-script/lists"}