PHPackages coroin/homeport - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [Utility & Helpers](/categories/utility) 4. / 5. coroin/homeport ActiveLibrary[Utility & Helpers](/categories/utility) coroin/homeport =============== Laradock multi-project helpers 1.2.1(6y ago)12.6kMITShell Since Jan 22Pushed 6y agoCompare [ Source](https://github.com/coroin/homeport)[ Packagist](https://packagist.org/packages/coroin/homeport)[ RSS](/packages/coroin-homeport/feed)WikiDiscussions master Synced yesterday READMEChangelogDependenciesVersions (7)Used By (0) Homeport ======== [](#homeport) Homeport is a script (`homeport`) installed your project-root with shortcuts to streamline your workflow while interacting with [laradock](http://laradock.io) in a multi-project environment. Prerequesites ------------- [](#prerequesites) Homeport requires [Docker](https://www.docker.com/community-edition#/download) and [Laradock](http://laradock.io). Install laradock in the same root folder as your other projects. > It is recommended to use the `~/code` folder ``` /home/USER/code/ /home/USER/code/ ├── a-project ├── a-project ├── b-project ├── b-project ├── ├── laradock ├── z-project ├── z-project ``` Run this to create the `~/code` folder (if it doesn't already exist) and install laradock: ``` mkdir -p ~/code && cd ~/code git clone https://github.com/Laradock/laradock.git cd laradock ``` Copy the `env-example` to `.env` and enable packages: ``` cp env-example .env perl -i -pe's/PHP_FPM_INSTALL_IMAP=false/PHP_FPM_INSTALL_IMAP=true/' .env perl -i -pe's/WORKSPACE_INSTALL_IMAP=false/WORKSPACE_INSTALL_IMAP=true/' .env perl -i -pe's/WORKSPACE_INSTALL_PYTHON=false/WORKSPACE_INSTALL_PYTHON=true/' .env ``` Installation (only required for a new project) ---------------------------------------------- [](#installation-only-required-for-a-new-project) Install Homeport in your project: ``` composer require coroin/homeport php artisan vendor:publish --provider="Homeport\HomeportServiceProvider" chmod +x homeport ``` Review the `homeport` script and customize for your project, if needed: ``` ## Homeport Configuration # 1. set path to laradock files LARADOCK="${HOME}/code/laradock" # note: must use ${HOME} instead of ~ # 2. set project name PROJECT="${PWD##*/}" # defaults to current folder # 3. specify database config DATABASE_NAME="${PROJECT}" # defaults to project-name DATABASE_PASS=root # DO NOT CHANGE (laradock default) DATABASE_TYPE=mariadb # [mysql, mariadb] # 4. select containers to run CONTAINERS="nginx ${DATABASE_TYPE} redis" # default uses nginx, database and redis ``` Initial Setup (required one time per project) --------------------------------------------- [](#initial-setup-required-one-time-per-project) Add entry to your hosts file: > It is recommended to use the `.test` top-level-domain for your localdev ``` 127.0.0.1 yourproject.test ``` > On Mac/\*NIX this file is located at `/etc/hosts`. On Windows, it is `C:\Windows\system32\drivers\etc\hosts` Create the database and nginx config file: ``` ./homeport setup ``` > Note: If this is the first time you have run this command, it may take some time to download and build the docker images. Usage ----- [](#usage) Any command not defined in the `homeport` script will default to being passed to the `docker-compose` command. If no command is used, it will run `docker-compose ps` to list the running containers used by laradock. ### Starting and Stopping Laradock [](#starting-and-stopping-laradock) ``` # start laradock ./homeport up # stop laradock ./homeport down # restart laradock ./homeport restart # same as running ./homeport down && ./homeport up ``` ### Artisan, Composer, and NPM [](#artisan-composer-and-npm) ``` # run artisan commands ./homeport artisan ./homeport art # "art" is a shortcut to "artisan" # run composer commands ./homeport composer ./homeport comp # "comp" is a shortcut to "composer" # run npm commands ./homeport npm ``` ### MySql and Redis [](#mysql-and-redis) ``` # access the database ./homeport sql # access the redis cli ./homeport redis ``` ### PHPUnit and Debugging [](#phpunit-and-debugging) ``` # run phpunit tests ./homeport test ./homeport t # "t" is a shortcut to "test" # tail the laravel log ./homeport tail ./homeport log # "log" is an alias to "tail" ./homeport log -f # follow ./homeport log -n 10 # show 10 lines of the log ``` Rebuilding or Repairing Laradock -------------------------------- [](#rebuilding-or-repairing-laradock) After an update to Laradock or making changes to the `.env` file, rebuild the docker images: ``` # start laradock ./homeport rebuild ./homeport repair # "repair" is an alias of rebuild ``` Upgrading Homeport ------------------ [](#upgrading-homeport) Run the following command each time `composer update` gives you a new version of `homeport` ``` # upgrade homeport ./homeport update ./homeport upgrade # "upgrade" is an alias of update ``` Learning Docker --------------- [](#learning-docker) If you're unfamiliar with Docker, check out Chris Fidao's awesome [Docker in Development](https://serversforhackers.com/s/docker-in-development) and [Shipping Docker](https://serversforhackers.com/shipping-docker) courses at [serversforhackers.com](https://serversforhackers.com). Contributing ------------ [](#contributing) 1. Fork this repo 2. Create your feature branch: `git checkout -b my-new-feature` 3. Commit your changes: `git commit -am 'Add some feature'` 4. Push to the branch: `git push origin my-new-feature` 5. Submit a pull request ### Health Score 31 — LowBetter than 66% of packages Maintenance20 Infrequent updates — may be unmaintained Popularity17 Limited adoption so far Community6 Small or concentrated contributor base Maturity67 Established project with proven stability Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~109 days Recently: every ~135 days Total 6 Last Release 2533d ago ### Community Maintainers ![](https://avatars.githubusercontent.com/u/7023957?v=4)[Erik Larson](/maintainers/coroin)[@coroin](https://github.com/coroin) --- Top Contributors [![coroin](https://avatars.githubusercontent.com/u/7023957?v=4)](https://github.com/coroin "coroin (18 commits)") ### Embed Badge ![Health badge](/badges/coroin-homeport/health.svg) ``` [![Health](https://phpackages.com/badges/coroin-homeport/health.svg)](https://phpackages.com/packages/coroin-homeport) ``` ### Alternatives [pimcore/platform-version Verified Pimcore Version 11326.6k6](/packages/pimcore-platform-version) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)