Command Reference

podman:setup, podman:publish and podman:generate only render files. They never call podman, so they work anywhere PHP runs. If you leave out the preset name, you're asked to pick one.

The rendered output goes to podman/ by default. Don't commit it: you can regenerate it any time. Installing, starting and removing services is done with lpod.

podman:setup

Renders all default presets. See Quick start.

php artisan podman:setup

# Use other presets than the defaults
php artisan podman:setup --preset=production

podman:publish PRESET

Copies a preset's quadlets/ and runtimes/ files into your project so you can edit them.

php artisan podman:publish production

# Overwrite files you already published
php artisan podman:publish production --force

podman:generate PRESET

Renders one preset into podman/, ready for lpod install. See Customizing for the placeholders it fills in.

php artisan podman:generate production

# Use a different host path for this run only
php artisan podman:generate development --working-path=/srv/my-app

--working-path overrides PODMAN_WORKING_PATH for a single run, without changing .env. See Setting up without PHP.

podman:s3-setup

Creates S3 buckets and adds a CORS policy to the ones browsers read from. Needs aws/aws-sdk-php. See S3 Buckets.

php artisan podman:s3-setup

podman:idle

Exits successfully when the app has no work in progress, and fails otherwise. lpod's idle check runs it in the queue worker before stopping the workers. See What counts as work in progress.

# Every check for something the app uses (queue, database, scout)
php artisan podman:idle

# Only these checks
php artisan podman:idle --services=queue,database

Backing up volumes

lpod remove and lpod uninstall delete the service's volumes, and there's no undo. Back up anything you want to keep first (pgsql, valkey, rustfs, typesense, mailpit):

# Archive a volume. They're named {app}-{service}, check with "podman volume ls"
podman volume export my-app-pgsql -o pgsql-backup.tar

# For databases, a dump is usually easier to restore elsewhere
lpod my-app-pgsql run sh -c 'pg_dump -U "$POSTGRES_USER" -d "$POSTGRES_DB"' > backup.sql

To restore, run podman volume import my-app-pgsql pgsql-backup.tar, or import the dump.