Installing on CentOS or Red Hat Linux distributions

Installing Rundeck

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=0
enabled=1
gpgkey=https://packages.rundeck.com/pagerduty/rundeckpro/gpgkey
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 page (opens new window) and run:

sudo rpm -i rundeckpro-enterprise-4.4.0-20220714-1.noarch.rpm

Quick install with yum

You can use this script to add the Rundeck yum repo and install Rundeck:

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

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

sudo yum update rundeck

Manual yum setup

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

[rundeck]
name=rundeck
baseurl=https://packages.rundeck.com/pagerduty/rundeck/rpm_any/rpm_any/$basearch
repo_gpgcheck=1
gpgcheck=0
enabled=1
gpgkey=https://packages.rundeck.com/pagerduty/rundeck/gpgkey
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300

Install rpm package directly

Download rpm package from the download page (opens new window) and run:

sudo rpm -i rundeck-4.4.0-20220714-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/ (opens 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 usermod (opens new window) command to modify a user account.