Rudder is a free, open source, and multi-platform tool that helps you automate system configurations across large IT infrastructure. This is an IT Infrastructure Automation & Compliance tool that allows you to manage and maintain your production infrastructure through its audit features. This works on most Linux operating systems including, Ubuntu, Debian, Fedora, RHEL, CentOS and SUSE. Rudder offers a set of rules that can be used to create low-level configuration patterns and monitor infrastructure compliance.
In this tutorial, we will learn how to install a Rudder server on Ubuntu 20.04.
- Server running Ubuntu 20.04.
- The root password is configured on the server.
Before starting, update your system package to the latest version with the following command:
apt-get update -y
After your system is updated, install other dependencies to your server by running the following command:
apt-get install apt-transport-https ca-certificates wget dirmngr gnupg software-properties-common -y
After all dependencies are installed, you can continue to the next step.
Install Rudder Server
By default, the Rudder package is not available in the default Ubuntu 20.04 repository. So you need to add the Rudder repository to your system.
First, download and add the GPG key with the following command:
wget --quiet -O- "https://repository.rudder.io/apt/rudder_apt_key.pub" | apt-key add -
Next, add the Rudder repository to APT with the following command:
sh -c 'echo "deb http://repository.rudder.io/apt/6.0/ bionic main" > /etc/apt/sources.list.d/rudder.list'
Next, update the repository and install the Rudder server with the following command:
apt-get update -y apt-get install rudder-server-root -y
After the installation is successfully completed, you must get the following output:
Setting up rudder-server-root (6.0.7-ubuntu18.04) ... Created symlink /etc/systemd/system/multi-user.target.wants/rudder-server.service → /lib/systemd/system/rudder-server.service. Processing triggers for libc-bin (2.31-0ubuntu9) ... Processing triggers for rsyslog (8.2001.0-1ubuntu1) ... Processing triggers for systemd (245.4-4ubuntu3) ... Processing triggers for man-db (2.9.1-1) ... Processing triggers for ca-certificates (20190110ubuntu1.1) ... Updating certificates in /etc/ssl/certs... 0 added, 0 removed; done. Running hooks in /etc/ca-certificates/update.d... done. done.
At this point, Rudder is installed on your server. You can now proceed to the next step.
Access Rudder Web Interface
Now, open your web browser and access the Rudder web interface using the https: // your-server-ip / rudder URL. You will see the Rudder login screen:
Provide the default Rudder username and password as admin / admin, and click the SIGN IN button. You will see the Rudder dashboard in the following screen:
Change the Default Admin Password
Next, it is recommended to change Rudder’s default admin password.
First, you must create a sha512 password hash. Click here to generate the sha512 hash password as shown below:
Please remember the password generated on the screen above.
Next, edit the rudder-users.xml file with the following command.
Find the section and modify password parameters with the password you generated:
<user name="admin" password="fd8547c880af5c47c3f0333596aa53bbefb7bd08bf4ae2b2b06f23a551b95967ad67c63a5d1c94d7c4b9780ce10be21c2999390d81ebe316c18cd1304eb7486d" role="administrator" />
Save and close the file when you are finished. Then, restart the Rudder dock service to apply changes:
systemctl restart rudder-jetty
Now, you can exit and re-enter Rudder with your new password.
Congratulations! You have successfully set up a Rudder server on Ubuntu 20.04. You can start installing client software and configure it to connect to the server node. Click here about installing the Rudder client software on Ubuntu.