{"id":19389082,"url":"https://github.com/interconnectit/laravel-local-server","last_synced_at":"2026-01-17T15:34:09.350Z","repository":{"id":142718032,"uuid":"191907736","full_name":"interconnectit/laravel-local-server","owner":"interconnectit","description":null,"archived":false,"fork":false,"pushed_at":"2026-01-16T17:34:08.000Z","size":47,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-01-17T05:40:52.273Z","etag":null,"topics":["laravel"],"latest_commit_sha":null,"homepage":"","language":"PHP","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/interconnectit.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2019-06-14T08:40:39.000Z","updated_at":"2026-01-16T17:33:30.000Z","dependencies_parsed_at":"2024-02-13T14:25:35.798Z","dependency_job_id":"a152a847-c4ab-4db9-b287-fa8aef2e14e2","html_url":"https://github.com/interconnectit/laravel-local-server","commit_stats":null,"previous_names":[],"tags_count":25,"template":false,"template_full_name":null,"purl":"pkg:github/interconnectit/laravel-local-server","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/interconnectit%2Flaravel-local-server","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/interconnectit%2Flaravel-local-server/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/interconnectit%2Flaravel-local-server/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/interconnectit%2Flaravel-local-server/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/interconnectit","download_url":"https://codeload.github.com/interconnectit/laravel-local-server/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/interconnectit%2Flaravel-local-server/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28511617,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-17T13:38:16.342Z","status":"ssl_error","status_checked_at":"2026-01-17T13:37:44.060Z","response_time":85,"last_error":"SSL_read: 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":["laravel"],"created_at":"2024-11-10T10:15:17.606Z","updated_at":"2026-01-17T15:34:09.292Z","avatar_url":"https://github.com/interconnectit.png","language":"PHP","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Laravel Local Server\n\nThe local server package providers a local development environment for Laravel projects. It is built on a containerized architecture using Docker images and Docker Compose to provide drop-in replacements for most components of the cloud infrastructure.\n\n## Requirements\n\nMake sure all dependencies have been installed before moving on:\n\n* [PHP](http://php.net/manual/en/install.php) \u003e= 7.2\n* [Composer](https://getcomposer.org/download/)\n* [Docker Desktop](https://www.docker.com/products/docker-desktop)\n\n## Installation\n\nYou can install the package via composer:\n\nAdd the following to your composer.json repositories \n```bash\n\"type\": \"composer\",\n\"url\": \"https://packages.interconnectit.com\"\n```\n\nThen run this command in your project directory.\n```bash\ncomposer require interconnectit/laravel-local-server --dev\n```\n\n## Usage\n\n### Env Vars\n- Set your `APP_URL` along the lines of `http://blog.localtest.me/`\n- Set your database connections \n```dotenv\n  DB_CONNECTION=mysql\n  DB_HOST=mysql\n  DB_PORT=3306\n  DB_DATABASE=laravel\n  DB_USERNAME=laravel\n  DB_PASSWORD=laravel\n ```\n- Set your Redis\n```dotenv\nREDIS_HOST=redis\nREDIS_PASSWORD=null\nREDIS_PORT=6379\n```\n- Set your drivers and queue vars\n```dotenv\nBROADCAST_DRIVER=redis\nCACHE_DRIVER=redis\nQUEUE_CONNECTION=redis\nSESSION_DRIVER=redis\n```\n- Set your mailer\n```dotenv\nMAIL_MAILER=smtp\nMAIL_HOST=mailhog\nMAIL_PORT=1025\nMAIL_USERNAME=null\nMAIL_PASSWORD=null\nMAIL_ENCRYPTION=null\nMAIL_FROM_ADDRESS=test@email.com\nMAIL_FROM_NAME=\"${APP_NAME}\"\n```\n\n### Artisan Commands\nThe local server uses the command line via the `composer` command.\n`php artisan` commands are replaced with `composer local-server artisan`. This is especially important for database related commands\n\nNavigate to your shell to your project's directory. You should already have installed Laravel by running `laravel new` or `composer create-project` but if not, do so now. See [Installing Laravel](https://laravel.com/docs/master#installing-laravel).\n\n### Starting the local server\n\nTo start the local server, simply run `composer local-server start`. The first time this will download all the necessary Docker images.\n\nOnce the initial install is over and download have completed, you should see the output:\n\n```sh\nStarting blog-proxy      ... done\nStarting blog-redis      ... done\nStarting blog-mailhog    ... done\nStarting blog-mysql      ... done\nStarting blog-backend    ... done\nStarting blog-phpmyadmin ... done\nStarting blog-worker     ... done\nStarting blog-scheduler  ... done\nStarting blog-frontend   ... done\n\nYour local server is ready!\nTo access your site visit: http://blog.localtest.me/\n```\n\nVisiting your site's URL should now work.\n\n### Stopping the local server\n\nTo stop the local server containers, simply run `composer local-server stop`.\n\n### Destroying the local server\n\nTo destroy the local server containers, simply run `composer local-server destroy`.\n\n### Viewing the local server status\n\nTo get details on the running local server status and containers, run `composer local-server status`. You should see output similar to:\n\n```sh\n     Name                    Command                  State                         Ports\n------------------------------------------------------------------------------------------------------------\nblog-backend      docker-php-entrypoint php-fpm    Up             9000/tcp\nblog-frontend     nginx -g daemon off;             Up             80/tcp\nblog-mailhog      MailHog                          Up             1025/tcp, 8025/tcp\nblog-mysql        docker-entrypoint.sh --def ...   Up (healthy)   3306/tcp, 33060/tcp\nblog-phpmyadmin   /docker-entrypoint.sh apac ...   Up             80/tcp\nblog-proxy        /entrypoint.sh traefik           Up             0.0.0.0:80-\u003e80/tcp, 0.0.0.0:8080-\u003e8080/tcp\nblog-redis        docker-entrypoint.sh redis ...   Up (healthy)   6379/tcp\nblog-scheduler    docker-php-entrypoint sh / ...   Up\nblog-worker       docker-php-entrypoint php  ...   Up\n```\n\nAll containers should have a status of \"Up\". If they do not, you can inspect the logs for each service by running `composer local-server logs \u003cservice\u003e`, for example, if `blog-mysql` shows a status other than \"Up\", run `composer local-server logs mysql`.\n\n### Viewing the local server logs\n\nOften you'll want to access logs from the services that local server provides. For example, PHP errors logs, Nginx access logs, or MySQL logs. To do so, run the `composer local-server logs \u003cservice\u003e` command, where `\u003cservice\u003e` can be any of `proxy`, `frontend`, `backend`, `worker`, `scheduler`, `phpmyadmin`, `mysql`, `redis`. This command will tail the logs (live update). To exit the log view, simply press `Ctrl+C`.\n\n### Ejecting the local server configuration\n\nIf you aren’t satisfied with the preselected services and configuration choices, you can `eject` at any time. It will copy all the configuration files into your project.\n\nYou don’t have to ever use `eject`. The curated service set is suitable for small to middle deployments, and you shouldn’t feel obligated to use this command. However I understand that this package wouldn’t be useful if you couldn’t customize it when you are ready for it.\n\nSee custom [recipes](../../wiki/Recipes).\n\n## Testing\n\n```bash\ncomposer test\n```\n\n## Security\n\nIf you discover any security related issues, please raise an issue in the tracker.\n\n## License\n\nThe MIT License (MIT). Please see [License File](LICENSE.md) for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finterconnectit%2Flaravel-local-server","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Finterconnectit%2Flaravel-local-server","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Finterconnectit%2Flaravel-local-server/lists"}