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

# [NAME](#NAME)

podman-farm-list - List the existing farms

# [SYNOPSIS](#SYNOPSIS)

**podman farm list** \[*options*]

**podman farm ls** \[*options*]

# [DESCRIPTION](#DESCRIPTION)

List all the existing farms.

# [OPTIONS](#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](#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](#SEE_ALSO)

[**podman(1)**](/man/os/podman/podman.1), [**podman-farm(1)**](/man/os/podman/podman-farm.1)

# [HISTORY](#HISTORY)

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

---

Document: podman-farm-list(1) from podman 6.0.0-r4 (Chainguard OS)