Installing on Ubuntu or Debian 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 apt-get install openjdk-11-jre-headless

Enterprise

Quick install with apt

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

Manual install with apt

Import the repo signing key:

curl -fsSL https://packages.rundeck.com/pagerduty/rundeck/gpgkey | sudo tee /etc/apt/trusted.gpg.d/rundeck-key.asc && chown root:root /etc/apt/trusted.gpg.d/rundeck-key.asc && chmod 644 /etc/apt/trusted.gpg.d/rundeck-key.asc

Add the following to /etc/apt/sources.list.d/rundeck.list replacing existing entries:

deb https://packages.rundeck.com/pagerduty/rundeckpro/any/ any main
deb-src https://packages.rundeck.com/pagerduty/rundeckpro/any/ any main

Update apt cache and install:

sudo apt-get update
sudo apt-get install rundeckpro-enterprise

Clean Install from deb repository when existing version is present

1. First, Check for existing versions installed

dpkg --list | grep -i rundeckpro-enterprise

2. Then, remove existing version to perform a clean install.

apt remove rundeckpro-enterprise
dpkg --purge rundeckpro-enterprise && apt install rundeckpro-enterprise

Install deb package directly

Download deb package from the download page and run:

sudo dpkg -i rundeckpro-enterprise_5.8.0-20241205-1_all.deb

Community

Quick install with apt

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

Manual install with apt

Import the repo signing key:

curl -L https://packages.rundeck.com/pagerduty/rundeck/gpgkey | sudo apt-key add -

Add the following to /etc/apt/sources.list.d/rundeck.list replacing existing entries:

deb https://packages.rundeck.com/pagerduty/rundeck/any/ any main
deb-src https://packages.rundeck.com/pagerduty/rundeck/any/ any main

Update apt cache and install:

sudo apt-get update
sudo apt-get install rundeck

Install deb package directly

Download deb package from the download page and run:

sudo dpkg -i rundeck_5.8.0-20241205-1_all.deb

Starting Rundeck

To start Rundeck:

sudo systemctl daemon-reload
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/ 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 project