github.com/containers/podman/v5@v5.1.0-rc1/docs/source/markdown/podman-farm.1.md (about)

     1  % podman-farm 1
     2  
     3  ## NAME
     4  podman\-farm - Farm out builds to machines running podman for different architectures
     5  
     6  ## SYNOPSIS
     7  **podman farm** *subcommand*
     8  
     9  ## DESCRIPTION
    10  Farm out builds to machines running Podman for different architectures.
    11  
    12  Manage farms by creating, updating, and removing them.
    13  
    14  Note: All farm machines must have a minimum podman version of v4.9.0.
    15  
    16  Podman manages the farms by writing and reading the `podman-connections.json` file located under
    17  `$XDG_CONFIG_HOME/containers` or if the env is not set it defaults to `$HOME/.config/containers`.
    18  Or the `PODMAN_CONNECTIONS_CONF` environment variable can be set to a full file path which podman
    19  will use instead.
    20  This file is managed by the podman commands and should never be edited by users directly. To manually
    21  configure the farms use the `[farm]` section in containers.conf.
    22  
    23  If the ReadWrite column in the **podman farm list** output is set to true the farm is stored in the
    24  `podman-connections.json` file otherwise it is stored in containers.conf and can therefore not be
    25  edited with the **podman farm remove/update** commands. It can still be used with **podman farm build**.
    26  
    27  ## COMMANDS
    28  
    29  | Command  | Man Page                                            | Description                                                       |
    30  | -------- | ----------------------------------------------------| ----------------------------------------------------------------- |
    31  | build    | [podman-farm\-build(1)](podman-farm-build.1.md)     | Build images on farm nodes, then bundle them into a manifest list |
    32  | create   | [podman-farm\-create(1)](podman-farm-create.1.md)   | Create a new farm                                                 |
    33  | list     | [podman-farm\-list(1)](podman-farm-list.1.md)       | List the existing farms                                           |
    34  | remove   | [podman-farm\-remove(1)](podman-farm-remove.1.md)   | Delete one or more farms                                          |
    35  | update   | [podman-farm\-update(1)](podman-farm-update.1.md)   | Update an existing farm                                           |
    36  
    37  ## SEE ALSO
    38  **[podman(1)](podman.1.md)**
    39  
    40  ## HISTORY
    41  July 2023, Originally compiled by Urvashi Mohnani (umohnani at redhat dot com)