Install Rudder Root server on Debian or Ubuntu

Table of Contents

Add the Rudder packages repository
Install your Rudder Root Server

Add the Rudder packages repository

Run the following commands as root to add the package repository GPG key and the repository itself:

apt-key adv --recv-keys --keyserver keyserver.ubuntu.com 474A19E8
echo "deb http://www.rudder-project.org/apt-3.0/ $(lsb_release -cs) main" > /etc/apt/sources.list.d/rudder.list
apt-get update
[Tip]Tip

If the HTTP Keyserver Protocol (11371/tcp) port is blocked on your network you can use this alternate command:

wget --quiet -O- "http://keyserver.ubuntu.com/pks/lookup?op=get&search=0x474A19E8" | apt-key add -

Install your Rudder Root Server

To begin the installation, you should simply install the rudder-server-root metapackage, which will install the required components:

apt-get install rudder-server-root
[Warning]Warning

Any nodes running syslogd (not syslog-ng or rsyslog) will fail to send any reports about the configuration rules they have applied to a Rudder Server running on Ubuntu (and only on Ubuntu). Rudder will apply rules on nodes but will never get reports from them. Therefore Rudder will not be able to calculate compliance.

The only supported platform using syslogd by default is RHEL/CentOS 5, and several workarounds are available to fix this:

  1. Install another syslog server on your nodes, such as rsyslog or syslog-ng.
  2. Change the rsyslog configuration on the Rudder server (running Ubuntu 12.04 or later) to use port 514 and authorize this in the rsyslog configuration.
  3. Setup iptables on the node to send syslog traffic to the correct port on your Rudder server.
  4. Use a different OS for your Rudder server that Ubuntu Server 12.04 or later.

Now jump to the next section to configure your server.

Prev Up Next
Install Rudder Server Home Install Rudder Root server on SLES