PHPackages                             open-southeners/sidecar-local - 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. [Testing & Quality](/categories/testing)
4. /
5. open-southeners/sidecar-local

ActiveLibrary[Testing & Quality](/categories/testing)

open-southeners/sidecar-local
=============================

An extension of Laravel Sidecar project to be able to use it locally with Docker

2.0.0(1mo ago)92.0kMITPHPPHP ^8.2CI passing

Since Oct 19Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/open-southeners/sidecar-local)[ Packagist](https://packagist.org/packages/open-southeners/sidecar-local)[ GitHub Sponsors](https://github.com/sponsors/open-southeners)[ RSS](/packages/open-southeners-sidecar-local/feed)WikiDiscussions main Synced today

READMEChangelog (10)Dependencies (18)Versions (13)Used By (0)

Laravel Sidecar Local [![required php version](https://camo.githubusercontent.com/5d276a0fba164aa2ea2372acfe8cb5a90e3fffff3eb263502649e5f6570a1997/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f7068702d762f6f70656e2d736f757468656e6572732f736964656361722d6c6f63616c)](https://www.php.net/supported-versions.php) [![codecov](https://camo.githubusercontent.com/0f31a62ece2f4db744a3a0d67c5186158d3c841b1147aa50c5bede31368eff05/68747470733a2f2f636f6465636f762e696f2f67682f6f70656e2d736f757468656e6572732f736964656361722d6c6f63616c2f6272616e63682f6d61696e2f67726170682f62616467652e7376673f746f6b656e3d4a4b496a617251664c61)](https://codecov.io/gh/open-southeners/sidecar-local) [![Edit on VSCode online](https://camo.githubusercontent.com/1e825ede949540f53ec4dce8dc8ad93376081856a01b7e3ce2f24f41c9133405/68747470733a2f2f696d672e736869656c64732e696f2f62616467652f7673636f64652d656469742532306f6e6c696e652d626c75653f6c6f676f3d76697375616c73747564696f636f6465)](https://vscode.dev/github/open-southeners/sidecar-local)
===================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================================

[](#laravel-sidecar-local---)

An extension of Laravel Sidecar project to be able to use it locally with Docker.

Getting started
---------------

[](#getting-started)

```
composer require open-southeners/sidecar-local
```

### Setting up

[](#setting-up)

Publish config file with the following command:

```
php artisan vendor:publish --provider="OpenSoutheners\\SidecarLocal\\ServiceProvider"
```

**Then don't forget to set your `sidecar.env` config option to `local` and the `sidecar.functions` with the ones you want to test locally to make this work.**

Run the following command to publish Docker Compose files into `resources/sidecar` with `--run` option to run Docker with all services locally:

```
php artisan sidecar:local --run
```

By default this starts a Docker-in-Docker daemon container and runs Traefik plus all Lambda runtime containers inside it. This keeps local Lambda containers isolated from the host Docker daemon while still exposing the local invoke endpoint on `localhost:6000`.

To **stop the services** you can just run the same but with `--stop` option:

```
php artisan sidecar:local --stop
```

Stopping uses a Sidecar-specific Compose project name and removes orphaned Sidecar function containers. It should not be run against your application's main Docker Compose or Sail stack.

### Laravel Sail

[](#laravel-sail)

Use `--sail` when running Sidecar Local from a Laravel Sail project:

```
php artisan sidecar:local --sail --run
```

Set `SIDECAR_LOCAL_HOST=sidecar-docker` when the Laravel application container needs to call the local Lambda endpoint through the DinD service. If your Sail network is not named `sail`, set `SIDECAR_LOCAL_DOCKER_NETWORK` to the actual external Docker network name.

Partners
--------

[](#partners)

[![skore logo](https://github.com/open-southeners/partners/raw/main/logos/skore_logo.png)](https://getskore.com)

License
-------

[](#license)

This package is open-sourced software licensed under the [MIT license](https://opensource.org/licenses/MIT).

###  Health Score

50

—

FairBetter than 95% of packages

Maintenance92

Actively maintained with recent releases

Popularity24

Limited adoption so far

Community7

Small or concentrated contributor base

Maturity63

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 ~86 days

Recently: every ~181 days

Total

12

Last Release

46d ago

Major Versions

1.x-dev → 2.0.02026-05-19

PHP version history (3 changes)1.0.0PHP ^8.1 || ^8.2

1.3.0PHP ^8.1

1.4.0PHP ^8.2

### Community

Maintainers

![](https://avatars.githubusercontent.com/u/2331052?v=4)[Ruben Robles](/maintainers/d8vjork)[@d8vjork](https://github.com/d8vjork)

---

Top Contributors

[![d8vjork](https://avatars.githubusercontent.com/u/2331052?v=4)](https://github.com/d8vjork "d8vjork (41 commits)")

---

Tags

lambda-functionslaravel-packagelaravel-sidecarlocal-developmentphptesting-lambda-functionstestinglaraveldockeropen-southenerslocal-developmentlaravel-sidecaraws-lambda-phplambda-php

###  Code Quality

TestsPHPUnit

Static AnalysisPHPStan

Type Coverage Yes

### Embed Badge

![Health badge](/badges/open-southeners-sidecar-local/health.svg)

```
[![Health](https://phpackages.com/badges/open-southeners-sidecar-local/health.svg)](https://phpackages.com/packages/open-southeners-sidecar-local)
```

###  Alternatives

[laravel/sail

Docker files for running a basic Laravel application.

1.9k205.7M1.3k](/packages/laravel-sail)[laravel/ai

The official AI SDK for Laravel.

1.0k3.2M194](/packages/laravel-ai)[illuminate/queue

The Illuminate Queue package.

21332.6M1.6k](/packages/illuminate-queue)[tightenco/jigsaw

Simple static sites with Laravel's Blade.

2.3k453.6k30](/packages/tightenco-jigsaw)[roots/acorn

Framework for Roots WordPress projects built with Laravel components.

9762.4M131](/packages/roots-acorn)[moonshine/moonshine

Laravel administration panel

1.3k253.1k81](/packages/moonshine-moonshine)

PHPackages © 2026

[Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)