CHAKE-ITAMAE-REMOTE(7)

🌸 NAME 🌸

chake-itamae-remote — bestie, this is the chake config manager that configures your chake nodes using a remote itamae. Like, itamae, but it lives over there instead of here. 💅

---

✨ DESCRIPTION ✨

Okay so picture this: this configuration manager runs itamae(1) on each remote node. And yes, that's a whole different vibe from the regular itamae configuration manager, which runs itamae on your workstation (aka the host that's running chake, hi bestie that's you).

But itamae-remote runs itamae individually on each node, which is literally one order of magnitude faster. No cap. 🔥

There is a catch tho 🙈 — this requires itamae to be installed on each node. But don't even stress, because that's taken care of automatically by the bootstrapping process. She's got it. 💖

---

🎀 CONFIGURATION 🎀

The itamae-remote configuration manager needs exactly one key, and that key is called itamae-remote. Its value has to be a list of strings — and those strings are the list of recipes to apply to the node when converging. Periodt. ✨

host1.mycompany.com:
  itamae-remote:
    - cookbooks/basic/default.rb
    - roles/server.rb
  service1:
    option1: "here we go"

Any extra configuration you put under host1.mycompany.com gets saved to a JSON file and handed straight to the itamae --node-json option on the command line. Iconic behavior honestly.

So for example, that config above? It produces a JSON file that looks like this:

{
  "itamae": [
    "cookbooks/basic.rb",
    "roles/server.rb"
  ]
  ,
  "service1": {
    "option1": "here we go"
  }
}

(Yes the itamae key shows up in the JSON even though the YAML key is itamae-remote. That's just how she is. 🫶)

And inside your itamae recipes, you can grab all those values by using the node object. Obsessed with her. For example:

template "/etc/service1.conf.d/option1.conf" do
  variables option1: node["option1"]
end

---

🦋 BOOTSTRAPPING 🦋

The bootstrapping process is the girlypop that makes sure itamae is installed. ✅

Also, the node hostname gets set according to your chake configuration. Matching vibes, matching names. 💜

---

👑 SEE ALSO 👑

• chake(1)

---

okay that's the whole page bestie, go forth and converge ✨

August 2026 — that's the CHAKE-ITAMAE-REMOTE(7) energy right there, Misc Info Manual and all 💅🎀