Usage

Configure and run the Kudu Linux Agent as a systemd service. Set up API keys, manage scan schedules, and connect to Kudu Cloud for remote management.

Configuration

Before starting the agent, set your Kudu Cloud API key. You can find your API key in the Cloud Dashboard under Settings.

kudu --cli config set cloud.apiKey "your-cloud-api-key"

Running the Agent

Test in Foreground

Run the agent in the foreground to verify everything is working before installing it as a service:

kudu --daemon

The agent will connect to Kudu Cloud and begin reporting. Press Ctrl+C to stop.

All-in-One Start

Set your API key and start the daemon in a single command:

kudu --daemon --api-key "your-cloud-api-key"

This writes the key to the config and starts the agent immediately.

Install as a systemd Service

For production use, install the agent as a systemd service so it starts automatically on boot and restarts on failure:

sudo kudu --cli service install
sudo systemctl enable --now kudu

Manage the Service

Command	Description
`sudo systemctl start kudu`	Start the agent
`sudo systemctl stop kudu`	Stop the agent
`sudo systemctl restart kudu`	Restart the agent
`sudo systemctl status kudu`	Check agent status

View Logs

journalctl -u kudu -f

Quick Start

Set up and run the agent in four steps:

# 1. Set your Cloud API key
kudu --cli config set cloud.apiKey "your-cloud-api-key"

# 2. Test in foreground
kudu --daemon

# 3. Install as a systemd service
sudo kudu --cli service install
sudo systemctl enable --now kudu

# 4. Check logs
journalctl -u kudu -f

Or all-in-one — set the key and start immediately:

kudu --daemon --api-key "your-cloud-api-key"