{"id":13396326,"url":"https://maxlab.github.io/stacker/","last_synced_at":"2025-03-13T22:32:08.623Z","repository":{"id":57016590,"uuid":"74264485","full_name":"Maxlab/stacker","owner":"Maxlab","description":"Stacker - The environment for local web development, ready for use.","archived":false,"fork":false,"pushed_at":"2018-07-15T05:32:12.000Z","size":242,"stargazers_count":365,"open_issues_count":3,"forks_count":23,"subscribers_count":21,"default_branch":"master","last_synced_at":"2025-03-02T20:57:40.207Z","etag":null,"topics":["dnsmasq","docker","docker-compose","lamp","laravel","mailcatcher","mysql","nginx","pgsql","php","php-container","rad","redis","symfony","symfony3","workspace","xampp","xdebug","yii2","zsh"],"latest_commit_sha":null,"homepage":"https://maxlab.github.io/stacker/","language":"Shell","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/Maxlab.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":"2016-11-20T09:35:35.000Z","updated_at":"2025-02-06T01:13:13.000Z","dependencies_parsed_at":"2022-08-22T09:40:38.571Z","dependency_job_id":null,"html_url":"https://github.com/Maxlab/stacker","commit_stats":null,"previous_names":[],"tags_count":27,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maxlab%2Fstacker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maxlab%2Fstacker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maxlab%2Fstacker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Maxlab%2Fstacker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Maxlab","download_url":"https://codeload.github.com/Maxlab/stacker/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243494289,"owners_count":20299792,"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":["dnsmasq","docker","docker-compose","lamp","laravel","mailcatcher","mysql","nginx","pgsql","php","php-container","rad","redis","symfony","symfony3","workspace","xampp","xdebug","yii2","zsh"],"created_at":"2024-07-30T18:00:44.949Z","updated_at":"2025-03-13T22:32:08.275Z","avatar_url":"https://github.com/Maxlab.png","language":"Shell","readme":"\u003cp align=\"center\"\u003e\n\u003cimg alt=\"Frameworks a lot - he's one!\" src=\"logo.png\"\u003e\n\u003c/p\u003e\n\n\n[![Latest Stable Version](https://poser.pugx.org/maxlab/stacker/v/stable)](https://packagist.org/packages/maxlab/stacker)\n[![Build Status](https://travis-ci.org/Maxlab/stacker.svg?branch=master)](https://travis-ci.org/Maxlab/stacker)\n[![License](https://poser.pugx.org/maxlab/stacker/license)](https://packagist.org/packages/maxlab/stacker)\n[![Latest Unstable Version](https://poser.pugx.org/maxlab/stacker/v/unstable)](https://packagist.org/packages/maxlab/stacker)\n\n## Introduction\n\n- [English](https://github.com/Maxlab/stacker)\n- [简体中文](https://github.com/Maxlab/stacker/blob/master/README_cn.md)\n\n#### Why stacker?\nStacker - This is a local environment for web development with everything you need. What is its benefit?\n1. You do not need to manually configure the web server and add to the hosts, just cloned it and immediately launched it in the browser. It looks so [demo](https://youtu.be/42BemUfK5-4)\n2. Inside, there is already everything that is needed in 90% of all cases. And if not, we will add it for you : )\n3. For you, there is a super zsh console with autocomplete and everything you need. Video with [presentation](https://youtu.be/N7HpPoNcaA4?list=PLD8VGB8i9TYha8YOd-deV6bX5hZco0ZGy) \n4. There is an autocompletion for Symfony and Laravel commands out of the box. For example, la5 and a double tab, will output a list of commands for which you can \"walk\" with arrows to select them\n5. It is faster analogs, the same homestead is just a turtle compared to it\n6. There is a [video course](https://www.youtube.com/playlist?list=PLD8VGB8i9TYha8YOd-deV6bX5hZco0ZGy)\n7. Friendly author, in case there are questions or suggestions\n8. Based on Docker. Wherever you can install Docker, you can install Stacker\n9. It is very simple to expand. The process of adding your own images with a couple of lines in docker-compose.yml\n10. Just try it!\n\n#### General goals\n- Frameworks a lot - he's one!\n- Everything is easy, nothing to migrate\n- Quickly start of developing locally\n- No overhead on settings! Сopied project and run\n- Zoo under a Docker, let the host mashine remains clean!\n\n\n#### Video demos (RU)\n- [Presentation](https://youtu.be/qVqzYMczuwM)\n- [PhpStorm + Xdebug + Stacker = profit!](https://youtu.be/RYnRamdZJ-Q)\n- [Console, Composer, Gulp, Npm, Gem, Bower](https://youtu.be/WBFMs35ucfk)\n- [Run Symfony, Laravel and native PHP scripts](https://youtu.be/TONMezpUqkc)\n\n## Requirements\n- Install [Docker](https://docs.docker.com/)\n- Install [Docker Compose](https://docs.docker.com/compose/install/) \u003e 1.8.0\n\n## Installation\n\n#### Get a stacker: \n```sh \n$ composer create-project maxlab/stacker \n# OR\n$ git clone git@github.com:Maxlab/stacker.git\n```\n\n#### Run in Stacker directory \n```sh \n# make ./workspace folder and make a symbolic link to your folder with all your projects \n$ mkdir workspace \u0026\u0026 ln -s /your_path/to_all_your_own_projects ./workspace\n# copy .env.dist to .env and change it\n$ cp .env.dist .env\n$ docker-compose build \u0026\u0026 docker-compose up -d \u0026\u0026 docker-compose ps\n$ mv ./test ./workspace\n```\n#### Set local DNS server\n\n```sh\n- Linux\n  /etc/resolv.conf\n- Mac\n  System Settings\n- Windows\n  Network Adapter Setting\n```\n\nset your local dns server to `127.0.0.1` , to prevent dnsmasq from running, you need to **set up the second DNS server**. Such as 8.8.8.8 or something else.\n\n- Then open http://test.php.dev/ in your browser\n\n\n- [Examples](https://youtu.be/42BemUfK5-4)\n\n#### For SSH\nCopy your ssh keys in the folder workspace\n```sh\n$ cp -R ~/.ssh ~/www/docker/stacker/workspace \n```\n#### Move your projects\n- Add your project in workspace folder `./workspace/\u003ccustomer\u003e/\u003cprojectname\u003e` (no need to restart, this will work out of the box)\n- Open http://customer.project.dev/ in your browser (if you do not have dnsmasq, you have to add your hosts file manually)\n\n## On the ship\n- mailcatcher   -\u003e schickling/mailcatcher:latest (all outgoing mail is sent to http://mail.dev/)\n- nginx         -\u003e nginx:1.10.1\n- elasticsearch -\u003e elasticsearch:5\n- mysql         -\u003e mysql:5.7\n- pgsql         -\u003e postgres:9.6   \n- php7xdebug    -\u003e php:7.1 + xdebug\n- dnsmasq  -\u003e  dnsmasq:latest\n- php5apache    -\u003e php:5apache for legacy\n- php7console   -\u003e stacker console\n- redis         -\u003e redis:3.0\n\n## Console\n- *ZSH* + [oh-my-zsh](http://ohmyz.sh/)\n- For frontend: nodejs, gem, npm, webpack, bower, gulp, uglify-js, uglifycss \n- For backend: composer, php, phpunit, symfony, symfony-autocomplete, Yii2 autocomplete\n- For automation deploy: dep ([Deployer](http://deployer.org/))\n\n## FAQ\n\n#### Which settings in the configs for my projects?\n- Database\n    - You can access the database in your app config use `db` for mysql and `pgsql` for postgresql\n        (files will be saved in the mysql directory so it will be saved after destroying or recreating the containers)\n    ```yaml\n      # Example for mysql\n      parameters:\n        database_host: mysql\n        database_port: 3306\n        database_name: sf\n        database_user: root\n        database_password: root\n\n      # Example for pgsql\n      parameters:\n        database_host: pgsql\n        database_port: 5433\n        database_name: sf\n        database_user: postgres\n        database_password: postgres\n      \n      # Example for redis\n      parameters:\n        database_host: redis\n        database_port: 6379\n    ```\n\n#### What external ports are listening images?\n- It's easy. For convenience, the external ports of the databases are offset by plus one. \n    For example, MySQL listens to port 3306 + 1 = 3307 and so on...\n- Check the file [docker-compose.yml](/docker-compose.yml) for more \n\n#### Xdebug + PhpStorm configuration \n\n- Watch [this video](https://youtu.be/RdmcGAAQGfI) (in Russian)\n\n1. Go to Settings -\u003e Languages \u0026 Frameworks -\u003e PHP\n2. Click the ... behind your interperter\n\n#### I have a lot of the Symfony project, is it possible to make a symbolic link to them? \n- Yes! It's much faster and easier, plus no need to move folders from the usual places.\n- In the directory with your projects, create a folder and copy all the projects from the Symfony code. \n  Now, make a link to your directory project in the directory with the Stacker, \n  remove a directory `./workspace` and rename your link to workspace - that's all! \n  Now all your Symfony projects is available from the browser.\n\n#### How to contact the any instances Staker in console?\nYou can do so:\n```sh \n$ /your_path/to_stacker_folder/bin/stacker console\n```\nBut, it will be much better:\n```sh\n# for bash\n$ echo 'export PATH=/your_path/to_stacker_folder/bin:$PATH' \u003e\u003e ~/.bashrc \u0026\u0026 source ~/.bashrc \n# for ~/.zshrc\n$ echo 'export PATH=/your_path/to_stacker_folder/bin:$PATH' \u003e\u003e ~/.zshrc \u0026\u0026 source ~/.zshrc\n# then restart console and run\n$ stacker console\n```\n\n#### Symfony completion\n```sh\n$ stacker console\n$ cd to_symfony_folder\n$ sf [tab*2] # for sf3 completion OR sf2 for sf2 completion\n```\n\n#### Laravel5 completion\n```sh\n$ stacker console\n$ cd to_symfony_folder\n$ la5 [tab*2]\n```\n\n## Commands\n```sh\n$ stacker usage # for list available commands\n$ stacker console # for enter to console\n$ stacker logs \u003ccont_name\u003e -f # for logs stream container\n$ stacker build \u0026\u0026 stacker down \u0026\u0026 stacker up \u0026\u0026 stacker ps # for full rebuild\n```\n\n## Support project\nYou can support the project in several ways:\n1. Becoming a sponsor - If you are interested in becoming a sponsor, please visit the Stacker [Patreon page](http://patreon.com/maxlab)\n2. Posting review - You can support the project by posting reviews in their social networks. Send a link to the review and we'll post it here!\n3. Buy a beer - [![Gratipay User](https://img.shields.io/gratipay/user/maxlab.svg)](https://gratipay.com/~maxlab) [![Bountysource](https://img.shields.io/bountysource/team/maxlabstacker/activity.svg)](https://www.bountysource.com/teams/maxlabstacker) [![Donate](https://img.shields.io/badge/Donate-PayPal-green.svg)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=Q477VJVB9STGS)\n","funding_links":["http://patreon.com/maxlab","https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=Q477VJVB9STGS"],"categories":["Development Setup"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/maxlab.github.io%2Fstacker%2F","html_url":"https://awesome.ecosyste.ms/projects/maxlab.github.io%2Fstacker%2F","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/maxlab.github.io%2Fstacker%2F/lists"}