Rundeck is an open source automation service with a web console, command line tools and a WebAPI. It lets you easily run automation tasks across a set of nodes.
Latest documentation: http://rundeck.org/docs/
Get Help: http://rundeck.org/help.html
See the Release Notes for the latest version information.
Primary build is supported with gradle. More info in the wiki.
The documentation can be built with pandoc.
Build the documentation. Artifacts in
cd docs make
RPM and DEB package builds
To build .rpm and .deb packages, you must first clone the rundeck packaging repo into the rundeck repo. A sample list of simple build steps is below, where $RELEASE_VERSION is the version you want to build, i.e. 3.2.7
git clone https://github.com/rundeck/rundeck cd rundeck git checkout refs/tags/v$RELEASE_VERSION git clone https://github.com/rundeck/packaging ./gradlew build -Penvironment=release cd packaging
For 3.2.x builds, check out the
maint-3.2.x branch of
git checkout maint-3.2.x mkdir -p artifacts cp ../rundeckapp/build/libs/rundeck*.war artifacts/ ./gradlew -PpackageRelease=$RELEASE_VERSION clean packageArtifacts
To build clean:
There are several install options: a self-contained war file, or RPM, or Debian.
To start from the rundeck-X.Y.war, put it in a directory named ~/rundeck, then execute:
java -Xmx1024m -Xms256m -XX:MaxMetaspaceSize=256m -server -jar rundeck-X.Y.war
If you'd like to install via RPM, you can use Yum:
rpm -Uvh http://repo.rundeck.org/latest.rpm yum install rundeck
OR install directly from RPM:
rpm -ivh rundeck-2.0.0-xxx.rpm rundeck-config-2.0.0-xxx.rpm
Once the RPM is installed, execute:
sudo /etc/init.d/rundeckd start
The server should launch on port 4440, with default username/password of
For Debian, download the .deb from the downloads page, then run:
dpkg -i rundeck-2.0.0-x.deb
- For more info and configuration information, see the Rundeck docs.
Java 8 (openjdk, oracle)
Pandoc (documentation build only)
Available online at http://rundeck.org/docs
Refer to the IDE Development Environment to get set up using IntelliJ IDEA or Eclipse/STS.
Do you have changes to contribute? Please see the Development wiki page.
Copyright 2020 Rundeck, Inc.
Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at
Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.