Installing on Red Hat, Amazon or Oracle Linux distributions
Installing on Red Hat, Amazon or Oracle Linux distributions
Installing Rundeck
Warning
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 Runbook 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 Runbook 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 and run:
sudo rpm -i rundeckpro-enterprise-5.7.0-20241021-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=1
enabled=1
gpgkey=https://packages.rundeck.com/pagerduty/rundeck/gpgkey,https://docs.rundeck.com/keys/BUILD-GPG-KEY-20240108.key
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
metadata_expire=300
Install rpm package directly
Download rpm package from the download page and run:
sudo rpm -i rundeck-5.7.0-20241021-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
- Navigate to http://localhost:4440/ in a browser
- Log in with the username admin and password admin
Rundeck is now up and running!
Next, learn how to create your first Runbook 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 command to modify a user account.