Before you can run workloads on your nodes, they will need to have our fudgelet installed on them.

The fudgelet is a lightweight agent that runs as a background process on your node; managing workloads, reporting hardware metrics and sending your application logs to the server.

It can be downloaded as a binary or installed via your preferred linux package manager. We also offer quick setup scripts for stream-lining the installation, which include setting up the configuration file that the fudgelet uses to source your API key.

Using a setup script

The quickest way to get started is via our setup scripts. These will grab the latest version of the fudgelet for you and initialise the fudgelet.toml file.


If you'd just like to download the latest fudgelet version and have your fudgelet.toml config file initialized, use the script.

Download the fudgelet binary using wget/curl

curl | { export CLUSTERFUDGE_API_KEY=$YOUR_API_KEY_HERE; sudo -E bash; }


If you'd prefer to install the fudgelet using the standard package manager for your distribution, you can use the script instead.

Install the fudgelet using a linux package manager

curl | { export CLUSTERFUDGE_API_KEY=$YOUR_API_KEY_HERE; sudo -E bash; }


If you'd just like to run the fudgelet, as the current user, without systemd, and without modifying your path, we offer a script as well.

Download and run the fudgelet as your current user


Custom Install

If you want more control over how the fudgelet is installed, you can download the latest packages direct from our package repository.

Download a fudgelet version

curl -fsSL -o $OUT$OS/$ARCH/latest/fudgelet

Apt repo

curl | gpg --dearmor -o /usr/share/keyrings/google-ar-archive-keyring.gpg
chmod 0644 /usr/share/keyrings/google-ar-archive-keyring.gpg

echo "deb [signed-by=/usr/share/keyrings/google-ar-archive-keyring.gpg] fudgelet main" | sudo tee -a  /etc/apt/sources.list.d/artifact-registry.list

Yum repo

sudo yum makecache

sudo tee -a /etc/yum.repos.d/artifact-registry.repo << EOL

sudo yum install -y fudgelet
sudo yum makecache


The fudgelet is configured via a fudgelet.toml file that, by default, is checked for at /etc/clusterfudge/fudgelet.toml.

There are two required values that must be set on all nodes:

Required fudgelet.toml configuration items

api_key = "$YOUR_API_KEY_HERE"
supervisor_address = ""

The following values can also be optionally configured:

Optional fudgelet.toml configuration items

verbosity = "trace|debug|info|warn|error"
log_file_path = "..."
log_file_directory = "..."
hostname_override = "..."
git_known_hosts_file_path = "..."
git_private_ssh_key_file_path = "..."