podman-farm(1) General Commands Manual podman-farm(1)
NAME
podman-farm - Farm out builds to machines running podman for different
architectures
SYNOPSIS
podman farm subcommand
DESCRIPTION
Farm out builds to machines running Podman for different architectures.
Manage farms by creating, updating, and removing them.
Note: All farm machines must have a minimum podman version of v4.9.0.
Podman manages the farms by writing and reading the podman-connec-
tions.json file located under $XDG_CONFIG_HOME/containers or if the env
is not set it defaults to $HOME/.config/containers. Or the PODMAN_CON-
NECTIONS_CONF environment variable can be set to a full file path which
podman will use instead. This file is managed by the podman commands
and should never be edited by users directly. To manually configure the
farms use the [farm] section in containers.conf.
If the ReadWrite column in the podman farm list output is set to true
the farm is stored in the podman-connections.json file otherwise it is
stored in containers.conf and can therefore not be edited with the pod-
man farm remove/update commands. It can still be used with podman farm
build.
COMMANDS
┌─────────┬───────────────────────┬──────────────────────────┐
│ Command │ Man Page │ Description │
├─────────┼───────────────────────┼──────────────────────────┤
│ build │ podman-farm-build(1) │ Build images on farm │
│ │ │ nodes, then bundle them │
│ │ │ into a manifest list │
├─────────┼───────────────────────┼──────────────────────────┤
│ create │ podman-farm-create(1) │ Create a new farm │
├─────────┼───────────────────────┼──────────────────────────┤
│ list │ podman-farm-list(1) │ List the existing farms │
├─────────┼───────────────────────┼──────────────────────────┤
│ remove │ podman-farm-remove(1) │ Delete one or more farms │
├─────────┼───────────────────────┼──────────────────────────┤
│ update │ podman-farm-update(1) │ Update an existing farm │
└─────────┴───────────────────────┴──────────────────────────┘
SEE ALSO
podman(1)
HISTORY
July 2023, Originally compiled by Urvashi Mohnani (umohnani at redhat
dot com)
podman-farm(1)
Generated by dwww version 1.16 on Tue Dec 16 06:25:46 CET 2025.