PHPackages foxws/laravel-podman - 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. [DevOps & Deployment](/categories/devops) 4. / 5. foxws/laravel-podman ActiveLibrary[DevOps & Deployment](/categories/devops) foxws/laravel-podman ==================== Podman Quadlet support to your Laravel application 1.7.1(3w ago)1747↓73.1%MITPHPPHP ^8.4CI passing Since Jul 12Pushed 1w agoCompare [ Source](https://github.com/foxws/laravel-podman)[ Packagist](https://packagist.org/packages/foxws/laravel-podman)[ Docs](https://github.com/foxws/laravel-podman)[ GitHub Sponsors](https://github.com/Foxws)[ RSS](/packages/foxws-laravel-podman/feed)WikiDiscussions main Synced 1w ago READMEChangelog (10)Dependencies (38)Versions (17)Used By (0) Laravel Podman ============== [](#laravel-podman) [![Latest Version on Packagist](https://camo.githubusercontent.com/09ad8603b610c23c1e5423387be6676e443533d413df78b9da146dcaeee3d094/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f666f7877732f6c61726176656c2d706f646d616e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/foxws/laravel-podman)[![GitHub Tests Action Status](https://github.com/foxws/laravel-podman/actions/workflows/run-tests.yml/badge.svg)](https://github.com/foxws/laravel-podman/actions?query=workflow%3Arun-tests+branch%3Amain)[![GitHub Code Style Action Status](https://github.com/foxws/laravel-podman/actions/workflows/fix-php-code-style-issues.yml/badge.svg)](https://github.com/foxws/laravel-podman/actions?query=workflow%3A%22Fix+PHP+code+style+issues%22+branch%3Amain)[![Total Downloads](https://camo.githubusercontent.com/b13e35af9c4f85974796660d9591f9a563ecf88c77005d234557dba2d8a5a365/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f666f7877732f6c61726176656c2d706f646d616e2e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/foxws/laravel-podman) Renders [Podman Quadlet](https://docs.podman.io/en/latest/markdown/podman-quadlet.1.html) units from your Laravel app's config, then installs them as [systemd-managed](https://docs.podman.io/en/latest/markdown/podman-systemd.unit.5.html) containers on your host — no all-in-one runtime, no lock-in. Swap any bundled part (Caddy for Nginx, Postgres for MySQL) for your own. See the [full documentation](https://foxws.github.io/laravel-podman/) (or browse [`docs/`](docs) directly): [Commands](docs/commands.md), [Customizing](docs/customizing.md), [Proxy](docs/proxy.md), [S3 Buckets](docs/s3.md), [`lpod` CLI](docs/lpod.md), [Setting up without PHP](docs/host-setup.md), [Comparison](docs/comparison.md), [CI: Building a Container Image](docs/ci-build.md). Requirements ------------ [](#requirements) - **Linux with systemd** (rootless or system-wide) — macOS, Windows, and WSL are not supported - **Podman** with the `quadlet` CLI plugin (`podman quadlet --help` should work) Installation ------------ [](#installation) ``` composer require foxws/laravel-podman --dev ``` ``` php artisan vendor:publish --tag="podman-config" ``` Only needed to render Quadlet units — install as a dev dependency and skip it in production. See [Customizing](docs/customizing.md) for every config key. Presets ------- [](#presets) PresetWhat it is`development`App + services, working copy live-mounted for local editing. **Enabled by default.**`frankenphp-octane`Production-style image, app code baked in. Commented out by default.`devcontainer`VS Code/JetBrains [Dev Containers](https://containers.dev/) image. **Enabled by default.**`proxy`[Caddy](https://caddyserver.com/) reverse proxy in front of the other services.`s3`CORS policy for S3-compatible storage buckets.Custom presets: publish one (`php artisan podman:publish frankenphp-octane`) without touching the others — see [Customizing](docs/customizing.md). Quick start ----------- [](#quick-start) 1. **Render** the default presets: ``` php artisan podman:setup ``` 2. **Install [`lpod`](https://github.com/foxws/lpod)** once per host — a dependency-free script, no PHP/Composer needed: ``` curl -fsSL -o ~/.local/bin/lpod https://github.com/foxws/lpod/releases/latest/download/lpod chmod +x ~/.local/bin/lpod ``` 3. **Install** each rendered service (the only step that needs `podman` itself): ``` lpod install development/app.quadlets --replace lpod install development/pgsql.quadlets --replace lpod install development/valkey.quadlets --replace lpod install proxy/proxy.quadlets --replace ``` 4. **Set secrets, then start:** ``` lpod my-app secrets lpod pgsql secrets lpod my-app up lpod my-app open ``` Trust the proxy's local certificate once — see [Proxy](docs/proxy.md#trusting-the-local-certificate). No PHP on the host? `lpod setup` renders the same way without it — see [Setting up without PHP](docs/host-setup.md). Commands reference ------------------ [](#commands-reference) CommandDescription`podman:setup`Generate the default set of presets in one go`podman:publish PRESET`Publish a preset for customization`podman:generate PRESET`Render a single preset`podman:s3-setup`Create S3 buckets and a CORS policy (requires `aws/aws-sdk-php`)Installing, listing, removing, and setting secrets is [`lpod`](https://github.com/foxws/lpod)'s job, not Artisan's. Full flag reference: [Commands](docs/commands.md). > **Warning:** `lpod remove`/`lpod uninstall` delete the Podman volumes they own (databases, uploads, search indexes), with no undo — see [Backing up volumes](docs/commands.md#backing-up-volumes). The `lpod` utility ------------------ [](#the-lpod-utility) [`lpod`](https://github.com/foxws/lpod) is a separate, dependency-free bash script — no PHP, Composer, or this package required to run it: ``` curl -fsSL -o ~/.local/bin/lpod https://github.com/foxws/lpod/releases/latest/download/lpod chmod +x ~/.local/bin/lpod ``` ``` lpod SERVICE COMMAND [options] [arguments] lpod my-app up lpod my-app artisan queue:work lpod my-app shell lpod install development/app.quadlets --replace lpod my-app secrets ``` This package ships one Composer binary, **`vendor/bin/lpod-setup`**, which renders presets inside a disposable container for hosts with Podman but no PHP. `lpod setup` is a shortcut for it — copy `bin/lpod-setup` next to wherever `lpod` lives on your `PATH`. Full command reference, shortening the call, and tips & tricks: [foxws/lpod](https://github.com/foxws/lpod). Testing ------- [](#testing) ``` composer test ``` Links ----- [](#links) - [CHANGELOG](CHANGELOG.md) - [Security policy](../../security/policy) - [foxws/lpod](https://github.com/foxws/lpod) — the CLI this package pairs with - [Podman Quadlet reference](https://docs.podman.io/en/latest/markdown/podman-systemd.unit.5.html) Credits ------- [](#credits) - [francoism90](https://github.com/foxws) - [All Contributors](../../contributors) AI, specifically [Claude](https://claude.com/product/claude-code), was used to help build this package. All AI-assisted output is reviewed by me, and I retain final say over everything that is implemented and released. License ------- [](#license) MIT. See [License File](LICENSE.md). ### Health Score 50 — FairBetter than 95% of packages Maintenance97 Actively maintained with recent releases Popularity21 Limited adoption so far Community9 Small or concentrated contributor base Maturity59 Maturing project, gaining track record Bus Factor1 Top contributor holds 90.4% 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 ~2 days Total 15 Last Release 23d ago Major Versions 0.0.2 → 1.0.02026-07-15 ### Community Maintainers ![](https://avatars.githubusercontent.com/u/5028905?v=4)[François M.](/maintainers/francoism90)[@francoism90](https://github.com/francoism90) --- Top Contributors [![francoism90](https://avatars.githubusercontent.com/u/5028905?v=4)](https://github.com/francoism90 "francoism90 (66 commits)")[![dependabot[bot]](https://avatars.githubusercontent.com/in/29110?v=4)](https://github.com/dependabot[bot] "dependabot[bot] (6 commits)")[![github-actions[bot]](https://avatars.githubusercontent.com/in/15368?v=4)](https://github.com/github-actions[bot] "github-actions[bot] (1 commits)") --- Tags containersdockerlaravellaravel-packagelaravel-saillinuxpodmanpodman-quadletpodman-systemdsailsystemdlaravelfoxwssystemdpodmanlaravel-podmanpodman-quadletpodman-quadlets ### Code Quality TestsPest Static AnalysisPHPStan Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/foxws-laravel-podman/health.svg) ``` [![Health](https://phpackages.com/badges/foxws-laravel-podman/health.svg)](https://phpackages.com/packages/foxws-laravel-podman) ``` ### Alternatives [laravel/ai The official AI SDK for Laravel. 1.1k6.4M360](/packages/laravel-ai)[spatie/laravel-backup A Laravel package to backup your application 6.1k26.6M281](/packages/spatie-laravel-backup)[laravel/sail Docker files for running a basic Laravel application. 1.9k220.0M1.5k](/packages/laravel-sail)[spatie/laravel-medialibrary Associate files with Eloquent models 6.2k47.7M734](/packages/spatie-laravel-medialibrary)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 255.2k](/packages/aedart-athenaeum)[illuminate/queue The Illuminate Queue package. 20433.5M1.9k](/packages/illuminate-queue) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)