Scroll to navigation

podman-farm-list(1) General Commands Manual podman-farm-list(1)

NAME

podman-farm-list - List the existing farms

SYNOPSIS

podman farm list [options]

podman farm ls [options]

DESCRIPTION

List all the existing farms.

OPTIONS

--format=format

Change the default output format. This can be of a supported type like 'json' or a Go template. Valid placeholders for the Go template listed below:

Placeholder Description
.Connections List of all system connections in the farm
.Default Indicates whether farm is the default
.Name Farm name
.ReadWrite Indicates if this farm can be modified using the podman farm commands

EXAMPLE

List all farms:

$ podman farm list
Name        Connections  Default     ReadWrite
farm1       [f38 f37]    false       true
farm2       [f37]        true        true

Show farms in JSON format:

$ podman farm list --format json
[


  {


    "Name": "farm1",


    "Connections": [


      "f38",


      "f37"


    ],


    "Default": false,


    "ReadWrite": true


  },


  {


    "Name": "farm2",


    "Connections": [


      "f37"


    ],


    "Default": true,


    "ReadWrite": true


  }
]

Show only farm names:

$ podman farm list --format "{{.Name}}"
farm1
farm2

Show detailed farm information:

$ podman farm list --format "Farm: {{.Name}} (Default: {{.Default}}, ReadWrite: {{.ReadWrite}})\nConnections: {{.Connections}}"
Farm: farm1 (Default: false, ReadWrite: true)
Connections: [f38 f37]
Farm: farm2 (Default: true, ReadWrite: true)
Connections: [f37]

SEE ALSO

podman(1), podman-farm(1)

HISTORY

July 2023, Originally compiled by Urvashi Mohnani (umohnani at redhat dot com)