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-connections.json  file  located under
       $XDG_CONFIG_HOME/containers or if the env is not set it defaults  to  $HOME/.config/containers.   Or  the
       PODMAN_CONNECTIONS_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
       podman 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)