Skip to main content

Installing on Red Hat, Amazon or Oracle Linux distributions


Installing on Red Hat, Amazon or Oracle Linux distributions

Installing Rundeck

Note

Rundeck depends on Java 11. The Java 14 packages will satisfy this dependency however Rundeck will not function properly with them. It is recommended to install the openjdk-11-jre-headless package manually.

sudo yum install java-11-openjdk-devel

Quick install with yum

You can use this script to add the Process Automation yum repo:

curl https://raw.githubusercontent.com/rundeck/packaging/main/scripts/rpm-setup.sh 2> /dev/null | sudo bash -s rundeckpro

Manual yum setup

Remove bintray-rundeckpro-rpm.repo if it exists.

Add the following entries to /etc/yum.repos.d/rundeck.repo replacing any existing entries:

[rundeckpro]
name=rundeckpro
baseurl=https://packages.rundeck.com/pagerduty/rundeckpro/rpm_any/rpm_any/$basearch
repo_gpgcheck=1
gpgcheck=1
enabled=1
gpgkey=https://packages.rundeck.com/pagerduty/rundeckpro/gpgkey,https://docs.rundeck.com/keys/BUILD-GPG-KEY-20240108.key
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300
sudo yum install java rundeckpro-enterprise

When new versions of Process Automation are released, you can upgrade to them using the command:

sudo yum update rundeckpro-enterprise

Install rpm package directly

Download rpm package from the download pageopen in new window and run:

sudo rpm -i rundeckpro-enterprise-5.1.0-20240214-1.noarch.rpm

Starting Rundeck

To start Rundeck:

sudo service rundeckd start

To verify that the service started correctly, tail the logs:

tail -f /var/log/rundeck/service.log

The service is ready once you see something similar to:

Grails application running at http://localhost:4440 in environment: production

Logging in for the first time

  1. Navigate to http://localhost:4440/open in new window in a browser
  2. Log in with the username admin and password admin

Rundeck is now up and running!

Next, learn how to create your first Process Automation project

Note about Linux Groups

If you installed Rundeck using the RPM installation method, it will have created a unix group called "rundeck".

$ groups rundeck
rundeck : rundeck

Consult the usermodopen in new window command to modify a user account.