lpod

A single bash script for managing Podman Quadlet services on the host. Wraps podman exec, podman quadlet, and systemctl; unrecognized commands pass straight through to podman.

Pairs naturally with foxws/laravel-podman, whose Artisan podman:* commands render Quadlet files, but lpod doesn't require it — point it at any Quadlet-managed service.

Requirements

• Linux with systemd (macOS, Windows, and WSL are not supported)
• Podman with Quadlet support

Install

curl -fsSL https://github.com/foxws/lpod/releases/latest/download/install.sh | bash

Installs lpod and lpod-setup to ~/.local/bin, verified against the release's checksums. Upgrade with lpod self-update. Dependency-free single script — no PHP or Composer required. See Installation for pinning a release, installing by hand, and a shell alias.

Usage

lpod SERVICE COMMAND [options] [arguments]

lpod app up            # start the service
lpod app shell         # shell into the container
lpod app artisan migrate

SERVICE is a Quadlet service name (your app, or a sibling like pgsql). See Usage for details.

Docs

Full documentation: browse docs/

• Installation
• Usage
• Commands reference
• Configuration

Links

• foxws/laravel-podman — the Laravel package lpod pairs with
• Podman Quadlet reference