Install the agent manually on Linux

How to use the generic tar.gz Package

Cagent runs on almost every Linux. If packages for your package manager are missing, try to install via the generic tar.gz package.

  1. Download the tag.gz file suitable for your architecture to the /tmp directory.

  2. Unpack the binary to /usr/local/bin.

  3. Create a new unprivileged users (don't run the agent with the root-user!)

  4. Create directory for the config.

  5. Install an init script. The used run time manager (initv, systemd, upstart) is recognized automatically.

Below you find an example for Alpine Linux.

FILE=cagent_${VERSION}_Linux_$(uname -m).tar.gz
cd /tmp
curl -LO${VERSION}/${FILE}
tar xf $FILE cagent -C /usr/local/bin
# Test the binary
cagent -version
# Create a user
adduser -s /sbin/nologin -S -D -H -h /etc/cagent/ cagent
# Install the init script
cagent -s cagent
# Create a config. Put your host credentials here!!
echo 'hub_url = ""
hub_user = "xxxxx"
hub_password = "xxxx"'>/etc/cagent/cagent.conf
# Start the agent
/etc/init.d/cagent start

Always check for the latest version on our Github Release Page. Only use stable version!

While most Linux distributions use Systemd to manage service, there are some "exotic" that don't. The command cagent -s cagent tries to detect the proper service manager to register cagent as a service. If this fails, you must implement your own solution to start cagent at boot and keep it running.