Skip to main content

Install Rundeck Community on Centos

Install Rundeck Community on Centos

RPM-based Linux distributions are very popular. Rundeck offers the repository and the specific package for this kind of distribution. In this guide, we will show you how to install Rundeck Community on a CentOS 7 operating system.

In this guide we'll cover:

  • How to install Rundeck Community on CentOS 7 operating system
  • How to configure Rundeck properly to access it

Prerequisites

If you planning to install CentOS 7 on a physical server consider the minimum requirements defined hereopen in new window. Considering the minimum Rundeck requirements, these specs should be up to at least 4GB of RAM, 2 cores per instance, and 20 GB of hard disk space. You can see all of the available mirrors to download the Centos 7 ISO install image hereopen in new window.

To install CentOS 7 on a cloud instance (with any provider like Amazon Web Services or Microsoft® Azure), make sure to cover the Rundeck minimal requirements defined here. In the case of Amazon Web Services, make sure to use an instance size of m4.large or larger.

You can find the full guide to install Centos 7 hereopen in new window.

The main package requirement for Rundeck is Java 11.

Steps to Install the Latest Rundeck Community Version on CentOS 7 Linux.

  1. Get and install the repository:
    curl https://raw.githubusercontent.com/rundeck/packaging/main/scripts/rpm-setup.sh 2> /dev/null | bash -s rundeck
  2. Verify the Java version to ensure it meets the requirement:
    java -version
    Example output (actual version numbers can vary):
    openjdk version "11.0.11" 2021-04-20 LTS
OpenJDK Runtime Environment 18.9 (build 11.0.11+9-LTS)
OpenJDK 64-Bit Server VM 18.9 (build 11.0.11+9-LTS, mixed mode, sharing)
  3. If you need to install the Java JRE:
    sudo yum install java-11-openjdk
  4. Install Rundeck:
    sudo yum install rundeck
  5. Start the Rundeck service:
    sudo systemctl start rundeckd
  6. Enable the Rundeck service at system boot:
    sudo systemctl enable rundeckd
  7. Rundeck is now up and running. The Rundeck service is available at the following URL:
    http://localhost:4440

Basic Rundeck Configuration

After installing Rundeck, by default the instance’s hostname is localhost. You won’t be able to access the Rundeck instance from any node on the network so you need to configure Rundeck to use the hostname where it is installed.

  1. Stop the Rundeck Service.
    systemctl stop rundeckd
  2. Open the rundeck-config.properties file (at /etc/rundeck path) with any text editor and update this line: grails.serverURL=http://localhost:4440 Set to your host name (e.g. “your-rundeck-hostname” is the Rundeck server hostname, you can check it executing the hostname command):
    grails.serverURL=http://your-rundeck-hostname:4440
  3. Open the framework.properties file (at /etc/rundeck path) and update these lines:
    framework.server.name = localhost
framework.server.hostname = localhost
framework.server.url = http://localhost:4440
    Set to your host name (“your-rundeck-hostname” is the Rundeck server hostname):
        framework.server.name = your-rundeck-hostname
    framework.server.hostname = your-rundeck-hostname
    framework.server.url = http://your-rundeck-hostname:4440
  4. Add the firewalld rule which allows the default Rundeck TCP port (4440):
    sudo firewall-cmd --permanent --zone=public --add-port=4440/tcp
  5. Restart the firewalld service:
    sudo firewall-cmd --reload
  6. Restart the Rundeck service to get the changes:
    systemctl restart rundeckd
    Now the Rundeck service is available using the hostname and from any network location: http://your-rundeck-hostname:4440

Additional Resources