podman-farm(1)

💖 podman-farm(1) — bestie edition 💖

okay so you found the podman-farm page, section 1 of the General Commands Manual, and honestly? this one's a whole vibe. it's the part of podman that lets you farm out builds to machines running podman for different architectures. like, a whole little farm of computers doing your bidding. iconic. 🌾✨

---

🌸 NAME 🌸

podman-farm — farm out builds to machines running podman for different architectures

---

✨ SYNOPSIS ✨

podman farm subcommand

---

🦋 DESCRIPTION 🦋

so basically, bestie: you're farming out builds to machines running Podman for different architectures. that's the whole thing. 🐄💻

you manage farms by creating, updating, and removing them. that's your three main character moves.

🚨 note note note: all farm machines must have a minimum podman version of v4.9.0. no cap. if your nodes are older than that, this is not the moment.

now, the way podman keeps track of your farms: it writes and reads the podman-connections.json file located under $XDG_CONFIG_HOME/containers, or if that env isn't set, it defaults to $HOME/.config/containers. alternatively you can set the PODMAN_CONNECTIONS_CONF environment variable to a full file path, and podman will use that instead. 🗂️

💀 do NOT touch that file. this file is managed by the podman commands and should never be edited by users directly. hands off, bestie, i'm serious. if you wanna manually configure the farms, use the [farm] section in containers.conf instead. that's the approved path. 🫶

and here's the tea about the ReadWrite column in the podman farm list output ☕:

• if ReadWrite is set to true, the farm is stored in the podman-connections.json file
• otherwise it's stored in containers.conf, which means it cannot be edited with the podman farm remove / podman farm update commands
• but listen — it can still totally be used with podman farm build 💅

---

👑 COMMANDS 👑

here's the squad, one bullet each because tables aren't allowed here and honestly bullet lists ate anyway:

• build → man page podman-farm-build(1) — Build images on farm nodes, then bundle them into a manifest list 🏗️
• create → man page podman-farm-create(1) — Create a new farm 🌱
• list → man page podman-farm-list(1) — List the existing farms 📋
• remove → man page podman-farm-remove(1) — Delete one or more farms 🗑️
• update → man page podman-farm-update(1) — Update an existing farm 🔄

---

🌈 SEE ALSO 🌈

• podman(1)

the way this one just points you back to the main character... main character energy fr fr.

---

📜 HISTORY 📜

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

---

okay that's the whole page, you're all caught up, go forth and farm responsibly 🧚‍♀️🌸

this was podman-farm(1) from the General Commands Manual, dated July 2023 — mwah, slay, periodt, bye bestie 💖🎀🦋