startap/sail-podman

Podman compatibility layer to @laravel/sail application.

1.0.3 2026-03-13 15:53 UTC

Requires

• php: ^8.0
• illuminate/console: ^9.52.16|^10.0|^11.0|^12.0|^13.0
• illuminate/contracts: ^9.52.16|^10.0|^11.0|^12.0|^13.0
• illuminate/support: ^9.52.16|^10.0|^11.0|^12.0|^13.0
• symfony/console: ^6.0|^7.0|^8.0
• symfony/yaml: ^6.0|^7.0|^8.0

Requires (Dev)

• orchestra/testbench: ^7.0|^8.0|^9.0
• phpstan/phpstan: ^1.10

Replaces

• laravel/sail: *

MIT

• André Paul Grandsire

• laravel
• docker
• sail
• podman

README

This is just a simple fork from Laravel Sail project, aimed to provide compatibility with Podman and Podman Composer. All we did was tweak some binaries to be able to recognize Podman instead of Docker when running Sail. All the rest of source code was left untouched for now.

🛡️ Can I rely on this package? Why not Sail?

Well, Sail it's very good. But they do not have plans to support Podman (see #83 and this comment from #198). We already use Podman and made a change locally on Sail binary, inside vendor folder.

That change got away with every new Sail update. So, to keep in track with Sail upstream changes and provide a compatibility layer with Podman, we create this package and change a few things in bin/sail file to be able to recognize Podman/Podman Compose as executable.

For now, these changes are hardcoded, but we can improve it later.

🤔 What's Laravel Sail?

Sail provides a Docker powered local development experience for Laravel that is compatible with macOS, Windows (WSL2), and Linux. Other than Docker, no software or libraries are required to be installed on your local computer before using Sail. Sail's simple CLI means you can start building your Laravel application without any previous Docker experience.

📜 You can read more about it on laravel.com/docs/sail or Laravel Sail GitHub repository.

📦 How to install?

You can use this package right from Packagist repository with Composer.

composer require --dev startap/sail-podman

About users and permissions

If you are facing an issue regarding user permissions and access file denied, try this workaround. After try it, please answer with a 👍 or 👎 so I can take action into this.

⚠️ Compatibility note

This package is based on laravel/sail package. Inside our composer.json we declare that our package replaces laravel/sail as a dev dependency.

So, if you already have Laravel Sail installed, Composer will automatically remove it when installing this package. If you uninstall it, it is possible to install laravel/sail again per their own rules and procedures.

How to contribute

If you want to contribute, suggest a feature or report a bug, be welcome. It's all in this repository: issues, discussions and pull requests.

Sponsor us

You can sponsor us via GitHub Sponsors. It is right on the sidebar.

License

This project is open-sourced software licensed under the MIT license.