{"id":43685875,"url":"https://github.com/faradey/madock","last_synced_at":"2026-02-05T02:38:28.861Z","repository":{"id":43385032,"uuid":"406900518","full_name":"faradey/madock","owner":"faradey","description":"Local development environment based on Docker","archived":false,"fork":false,"pushed_at":"2026-01-19T16:36:43.000Z","size":3409,"stargazers_count":32,"open_issues_count":1,"forks_count":9,"subscribers_count":4,"default_branch":"master","last_synced_at":"2026-01-19T22:49:47.073Z","etag":null,"topics":["docker","local-development","magento","magento2"],"latest_commit_sha":null,"homepage":"","language":"Go","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/faradey.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2021-09-15T19:29:03.000Z","updated_at":"2026-01-19T16:36:46.000Z","dependencies_parsed_at":"2024-03-03T11:31:26.830Z","dependency_job_id":"ff134a1c-246b-4f8e-8b18-b521a7339e9f","html_url":"https://github.com/faradey/madock","commit_stats":{"total_commits":827,"total_committers":3,"mean_commits":275.6666666666667,"dds":"0.025392986698911768","last_synced_commit":"7ca18dc3edbee4c08e15b53001b9c65513bfc0a7"},"previous_names":[],"tags_count":38,"template":false,"template_full_name":null,"purl":"pkg:github/faradey/madock","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faradey%2Fmadock","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faradey%2Fmadock/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faradey%2Fmadock/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faradey%2Fmadock/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/faradey","download_url":"https://codeload.github.com/faradey/madock/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/faradey%2Fmadock/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29107720,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-05T02:25:47.218Z","status":"ssl_error","status_checked_at":"2026-02-05T02:25:44.497Z","response_time":65,"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","local-development","magento","magento2"],"created_at":"2026-02-05T02:38:28.764Z","updated_at":"2026-02-05T02:38:28.849Z","avatar_url":"https://github.com/faradey.png","language":"Go","funding_links":["https://www.buymeacoffee.com/faradey"],"categories":[],"sub_categories":[],"readme":"\u003cimg alt=\"Local development environment based on Docker\" src=\"media/madock-logo.png\" title=\"Madock\" width=\"150\"/\u003e\n\n# madock\nLocal development environment based on Docker\n\nSupported platforms: Magento2, PWA, Shopify, Shopware, Custom PHP projects.\n\n[![GoDoc](https://godoc.org/github.com/faradey/madock?status.svg)](https://godoc.org/github.com/faradey/madock)\n[![Go Report Card](https://goreportcard.com/badge/github.com/faradey/madock)](https://goreportcard.com/report/github.com/faradey/madock)\n[![GitHub release](https://img.shields.io/github/release/faradey/madock.svg)](https://github.com/faradey/madock/releases)\n[![GitHub license](https://img.shields.io/github/license/faradey/madock.svg)](https://opensource.org/license/mit/)\n[![GitHub issues](https://img.shields.io/github/issues/faradey/madock.svg)](https://github.com/faradey/madock/issues)\n\n## Description\n`madock` is a local Docker-based environment that allows you to run PHP projects.\nThis project is written on Golang, and it is distributed under a MIT License.\n\n## Key Features\n* Automatic project setup\n* Two or more projects can work simultaneously\n* **Magento** as a separate service. Works by default. Learn [more](docs/magento.md)\n* **PWA Studio** as a separate service\n* **Shopify** as a separate service. Learn [more](docs/shopify.md)\n* **Custom PHP project** as a separate service\n* **Shopware** as a separate service. Learn [more](docs/shopware.md)\n* **PrestaShop** as a separate service. Learn [more](docs/prestashop.md)\n* Cron support\n* Flexible configuration for each project\n* Database import and export in two clicks\n* Simple viewing of logs with one command\n* Debug support\n* Synchronization of the local database and media files with the dev site\n* Additional services: phpmyadmin, redis, rabbitMQ, elasticsearch, Kibana, ioncube, xdebug, cron\n* LiveReload. Learn [more](docs/livereload.md)\n* Mailpit (email testing tool for developers)\n* Magento Cloud\n* Composer patches in two clicks\n* Magento Functional Testing Framework (MFTF). Learn [more](docs/mftf.md)\n* Scopes. Learn [more](docs/scopes.md)\n* Configuration in a project. Learn [more](docs/config.md)\n* Snapshots. Learn [more](docs/snapshot.md)\n* Isolation mode [more](docs/isolation.md)\n* Varnish Cache [more](docs/varnish.md)\n* Custom commands [more](docs/custom_commands.md)\n\n## Tested on\n* Linux (Ubuntu 20.04)\n* macOS (Monterey, Sonoma)\n* Windows (10, 11)\n\n## Video\n\n[![madock - install the two Magento 2 projects](https://i9.ytimg.com/vi/_9NvZak_kt8/mq1.jpg?sqp=CPTN95cG\u0026rs=AOn4CLCdHqilfuAftZYHtejLn8v52qWP3g)](https://www.youtube.com/watch?v=_9NvZak_kt8)\n\n## Installation\n\nYou need 5 things on your local machine: `git`, `docker`, `docker-compose`, `golang` and `madock`\n\n_The new version 2 is not backwards compatible with version 1. \nIf you have problems with version 2, you can use version 1.x temporarily as it is more stable. \nVersion 1 does not receive any more improvements. \nTo use version 1 you should switch to [master-1.x.x](https://github.com/faradey/madock/tree/master-1.x.x) branch_\n\nFollow the installation steps for your system.\n\u003cdetails\u003e\n\u003csummary\u003eMac\u003c/summary\u003e\n\n1. Install [Docker](https://docs.docker.com/docker-for-mac/install/)\n2. Install [Golang](https://go.dev/doc/install)\n3. Clone this repo and follow into folder \"madock\"\n```\ngit clone git@github.com:faradey/madock.git\n```\nIf you got error \"git@github.com: Permission denied (publickey).\" see [solution](https://docs.github.com/en/authentication/troubleshooting-ssh/error-permission-denied-publickey#verify-the-public-key-is-attached-to-your-account)\n\n4. Go to the cloned directory\n```shell\ncd madock\n```\n5. Compile\n```\nRun command below for Apple M1\n\nGOARCH=arm64 go build -o madock\n```\n```\nRun command below for Apple Intel\n\ngo build -o madock\n```\n6. Add `madock` bin into your `$PATH`\n```shell\nRun command below for Apple M1\n\nsudo ln -s absolute_path_to_your_madock_dir/madock /opt/homebrew/bin/\n```\n```shell\nRun command below for Apple Intel\n\nsudo ln -s absolute_path_to_your_madock_dir/madock /usr/local/bin/\n```\n7. Open a new terminal tab/window and check that `madock` works\n```\nwhich madock\nmadock\n```\n8. Optionally you can also apply these performance tweaks\n    * [http://markshust.com/2018/01/30/performance-tuning-docker-mac](http://markshust.com/2018/01/30/performance-tuning-docker-mac)\n\u003c/details\u003e\n\n\u003cdetails\u003e\n\u003csummary\u003eLinux\u003c/summary\u003e\n\n1. Install docker\n   * Install Docker on [Debian](https://docs.docker.com/engine/installation/linux/docker-ce/debian/)\n   * Install Docker on [Ubuntu](https://docs.docker.com/engine/installation/linux/docker-ce/ubuntu/)\n   * Install Docker on [CentOS](https://docs.docker.com/engine/installation/linux/docker-ce/centos/)\n2. Configure permissions\n   * [Manage Docker as a non-root user](https://docs.docker.com/install/linux/linux-postinstall/)\n3. Install [Docker-compose](https://docs.docker.com/compose/install/)\n4. Install [Golang](https://go.dev/doc/install)\n5. Clone this repo and follow into folder \"madock\"\n```\ngit clone git@github.com:faradey/madock.git\n```\nIf you got error \"git@github.com: Permission denied (publickey).\" see [solution](https://docs.github.com/en/authentication/troubleshooting-ssh/error-permission-denied-publickey#verify-the-public-key-is-attached-to-your-account)\n\n6. Compile\n```\ngo build -o madock\n```\n7. Add `madock` bin into your `$PATH`\n```\nln -s absolute_path_to_your_madock_dir/madock /usr/local/bin/\n```\n8. Open a new terminal tab/window and check that `madock` works\n```\nwhich madock\nmadock\n```\n\u003c/details\u003e\n\n## Project Setup\n```shell\ncd \u003cyour_project\u003e\nmadock setup --download --install # for a new empty project with the clean Magento\nmadock setup # for an existing project\n```\n\n## Usage\n### Start Application\n```\nmadock start\nmadock composer install\nsudo vim /etc/hosts\n// Add -\u003e 127.0.0.1 \u003cyour-domain\u003e\n```\n### Workflow\nSee detailed documentation about development workflow with madock\nIMPORTANT: Please, read all items before starting work.\n* [Development Workflow](docs/workflow.md)\n\n## More Documentation\n\n* [Deployment Guide](docs/deployment-guide.md) (Setup existing projects on macOS, Linux, Windows)\n* [JSON Output](docs/json_output.md)\n* [VSCODE + Xdebug Setup](docs/xdebug_vscode.md)\n* [PHPStorm + Xdebug Setup](docs/xdebug_phpstorm.md)\n* [Docker images list](docs/docker_images.md)\n* [Customizations](docs/customizations.md)\n* [Database import, export, synchronization, phpmyadmin](docs/database.md)\n* [Media synchronization](docs/media.md)\n* [Cron](docs/cron.md)\n* [ENV variables](docs/env.md)\n* Kibana. URL http://{you_domain_name}/kibana\n* Mailpit. Default URL http://localhost:8025\n* [Store scopes](docs/store_scopes.md): website vs store\n\n## Donations\nIf you find it useful and want to invite us for a beer, just click on the donation button. Thanks!\n\n[![\"Buy Me A Coffee\"](https://www.buymeacoffee.com/assets/img/custom_images/orange_img.png)](https://www.buymeacoffee.com/faradey)\n\n## Resources\nThis project has been possible thanks to the following resources:\n\n* [docker-magento](https://github.com/markoshust/docker-magento)\n* [dockergento](https://github.com/ModestCoders/magento2-dockergento)\n\n## License\n\n* [The MIT License](https://opensource.org/licenses/MIT)\n\n## Copyright\n(c) faradey\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaradey%2Fmadock","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffaradey%2Fmadock","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffaradey%2Fmadock/lists"}