{"id":21700637,"url":"https://github.com/awps/wpdock","last_synced_at":"2026-04-05T21:05:23.546Z","repository":{"id":246961893,"uuid":"824735856","full_name":"awps/wpdock","owner":"awps","description":"CLI tool to manage your WordPress Docker environment. It provides commands to initialize, start, stop, and manage your WordPress Docker containers, as well as install WordPress, handle cron jobs, and manage the site with WP CLI.","archived":false,"fork":false,"pushed_at":"2025-02-06T07:43:51.000Z","size":1799,"stargazers_count":0,"open_issues_count":3,"forks_count":0,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-02-06T08:35:10.913Z","etag":null,"topics":["docker","wordpress"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/wpdock","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/awps.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-07-05T20:17:47.000Z","updated_at":"2024-07-29T18:41:26.000Z","dependencies_parsed_at":"2024-12-26T17:37:59.831Z","dependency_job_id":null,"html_url":"https://github.com/awps/wpdock","commit_stats":null,"previous_names":["awps/wpdock"],"tags_count":3,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awps%2Fwpdock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awps%2Fwpdock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awps%2Fwpdock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/awps%2Fwpdock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/awps","download_url":"https://codeload.github.com/awps/wpdock/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":244645065,"owners_count":20486923,"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","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","wordpress"],"created_at":"2024-11-25T20:15:07.494Z","updated_at":"2025-12-30T22:45:12.923Z","avatar_url":"https://github.com/awps.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# wpdock\n\n\u003e [!WARNING]\n\u003e # 🚧 Beta Warning 🚧\n\u003e \n\u003e **Warning: This repository is currently in beta.**\n\u003e \n\u003e Please be aware that this project is still under active development. As a result, the methods, APIs, and overall functionality may change frequently and without notice. I recommend using this project for testing and development purposes only and not in production environments.\n\u003e \n\u003e I appreciate your interest and contributions! If you encounter any issues or have suggestions, please feel free to open an issue or submit a pull request.\n\u003e \n\u003e Thank you for your understanding and support!\n\n\n`wpdock` is a command-line tool to manage your WordPress Docker environment. It provides commands to initialize, start, stop, and manage your WordPress Docker containers, as well as install WordPress, handle cron jobs, and manage the site with WP CLI.\n\n## Installation\n\nTo install `wpdock`, you need to have [Node.js](https://nodejs.org/) and [npm](https://www.npmjs.com/) installed. You can install `wpdock` globally using the following command:\n\n```sh\nnpm install -g wpdock\n```\n\n## Usage\n\nAfter installing `wpdock`, you can use it to manage your WordPress Docker environment. Below are the available commands:\n\n### Commands\n\n#### `wpdock init`\n\nGenerate the WordPress project files and include the Docker configuration. This sets up a basic structure for your WordPress project, including the necessary Docker configuration files.\n\n**Usage:**\n\n```sh\nwpdock init\n```\n\n**What to expect:**\n\n- The current directory will be populated with the following files:\n  - `.env`\n  - `custom.ini`\n  - `Dockerfile`\n  - `docker-compose.yml`\n- These files are pre-configured to work with Docker, allowing you to quickly spin up a WordPress environment.\n\n**Example:**\n\n```sh\n$ mkdir my-wordpress-site\n$ cd my-wordpress-site\n$ wpdock init\n# Copied .env to current directory\n# Copied custom.ini to current directory\n# Copied Dockerfile to current directory\n# Copied docker-compose.yml to current directory\n```\n\n#### `wpdock start`\n\nStart the Docker containers for the WordPress environment. This command brings up the Docker containers as defined in your `docker-compose.yml` file.\n\n**Usage:**\n\n```sh\nwpdock start\n```\n\n**What to expect:**\n\n- The Docker containers for your WordPress environment will start, and you will see logs indicating their status.\n\n**Example:**\n\n```sh\n$ wpdock start\n# docker-compose: Creating network \"my-wordpress-site_default\" with the default driver\n# docker-compose: Creating volume \"my-wordpress-site_db_data\" with default driver\n# docker-compose: Creating my-wordpress-site-mysql-1 ... done\n# docker-compose: Creating my-wordpress-site-wordpress-1 ... done\n```\n\n#### `wpdock stop`\n\nStop the Docker containers for the WordPress environment. This command stops all running containers defined in your `docker-compose.yml` file.\n\n**Usage:**\n\n```sh\nwpdock stop\n```\n\n**What to expect:**\n\n- The Docker containers for your WordPress environment will stop.\n\n**Example:**\n\n```sh\n$ wpdock stop\n# Stopping my-wordpress-site-wordpress-1 ... done\n# Stopping my-wordpress-site-mysql-1 ... done\n```\n\n#### `wpdock delete`\n\nStop and remove all Docker containers and custom networks. This command is useful for cleaning up your Docker environment.\n\n**Usage:**\n\n```sh\nwpdock delete\n```\n\n**What to expect:**\n\n- All Docker containers and custom networks associated with your WordPress environment will be stopped and removed.\n\n**Example:**\n\n```sh\n$ wpdock delete\n# Stopping my-wordpress-site-wordpress-1 ... done\n# Removing my-wordpress-site-wordpress-1 ... done\n# Stopping my-wordpress-site-mysql-1 ... done\n# Removing my-wordpress-site-mysql-1 ... done\n# Removing network my-wordpress-site_default\n```\n\n#### `wpdock bash`\n\nOpen a bash shell in the WordPress container. This allows you to interact with the WordPress container directly. **Direct access to the WP CLI commands**.\n\n**Usage:**\n\n```sh\nwpdock bash\n```\n\n**What to expect:**\n\n- A bash shell will open inside the WordPress container, allowing you to run commands directly.\n\n**Example:**\n\n```sh\n$ wpdock bash\n# root@wordpress-container:/var/www/html#\n```\n\n#### `wpdock install`\n\nInstall WordPress if not already installed. You will be prompted for site title, admin username, admin password, and admin email.\n\n**Usage:**\n\n```sh\nwpdock install\n```\n\n**What to expect:**\n\n- The command will check if WordPress is installed. If not, it will prompt you for the necessary information and proceed with the installation.\n\n**Example:**\n\n```sh\n$ wpdock install\n# Site Title: My WordPress Site\n# Admin Username: admin\n# Admin Password: ********\n# Admin Email: admin@example.com\n# WordPress installed successfully.\n```\n\n#### `wpdock multisite-install`\n\nInstall WordPress multisite if not already installed. You will be prompted for site title, admin username, admin password, and admin email.\n\n**Usage:**\n\n```sh\nwpdock multisite-install\n```\n\n#### `wpdock cron`\n\nManage WordPress cron jobs. This command allows you to start, stop, and manage cron jobs for your WordPress site.\n\n**Usage:**\n\n```sh\nwpdock cron [-i interval] [-b] [-k] [-s] [-h]\n```\n\n- `-i interval`: The interval between pings in seconds (default: 10)\n- `-b`: Run in background\n- `-k`: Kill all cron processes running in the background\n- `-s`: Use HTTPS instead of HTTP\n- `-h`: Display this help message\n\n**Examples:**\n\nRun cron in the background:\n\n```sh\n$ wpdock cron -i 60 -b\n# Cron is running in the background. PID: 12345\n```\n\nKill all running cron processes:\n\n```sh\n$ wpdock cron -k\n# All cron processes have been killed.\n```\n\nDisplay help message for cron:\n\n```sh\n$ wpdock cron -h\n# Usage: wpdock cron [-i interval] [-b] [-k] [-s] [-h]\n#   -i interval  The interval between pings in seconds (default: 10)\n#   -b           Run in background\n#   -k           Kill all cron processes running in the background\n#   -s           Use HTTPS instead of HTTP\n#   -h           Display this help message\n```\n\n## License\n\nThis project is licensed under the ISC License.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fawps%2Fwpdock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fawps%2Fwpdock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fawps%2Fwpdock/lists"}