# System Configurations

The Rundeck GUI has a Configuration Page which lets you view and manage system wide configuration settings.

If you have admin role access, when you log in, you will see the "Configure" icon in the header:

Configure Settings Icon
Configure Settings Icon

This page contains links to manage Project configuration as well as system level configuration information.

Configure Menu
Configure Menu

TIP

Some settings and screenshots show Enterprise version features and may not be available in the open source version.

# Key Storage

The Key Storage facility provides GUI backed by an API to manage public, private keys and passwords. These stored keys are used by both Node Executor and File Copier plugins. Project configuration settings allow you to reference a key path for both the default Node Executor and File Copier (see above.

Keys can be stored either using an uploaded file or as text input. Public key data can be retrieved once stored. Private key and password data is only available to the node execution plugins.

# Key store organization

You can organize the keys similar to how you locate files in a file system, using convention to define the folder structure. Here's an example convention that uses three fields to manage keys.

keys/projects/{project}/nodes/{node}/{identity}.pem convention

The fields in the pattern provide slots to allow multiple projects and users.

  • project: project name
  • node: might be a specific node or could be a class name like 'www'.
  • identity: the name of the user.

# Add Private Key with text

The Key Store page provides a simple browser to navigate the folders and perform actions on the keys.

Press the "Add or Upload a Key" button.

Key Storage browser
Key Storage browser

Next, choose "Private Key" for the Key type.

Key Type menu
Key Type menu

Key data can be added using the content of an uploaded file or as text input.

Choose the "Enter text" option. Paste the key content here.

You will also need to enter the storage path and give the key a name.

Add a key and enter text
Add a key and enter text

Here's the form with all the input.

Press the "Save" button.

Key Storage UI
Key Storage UI

After the key has been saved, the browser will be updated.

Key Storage page listing
Key Storage page listing

# Add Private Key with file

Key Storage file upload
Key Storage file upload

# Add a password

Key Storage UI
Key Storage UI

# Delete a key

Key Storage UI
Key Storage UI

# System Configuration

This page displays key configuration settings. Modify the associated configuration file to change a configuration setting.

System settings
System settings

# Access Control

System security is managed through configuration files. This page describes the current settings the files to change them.

Security settings
Security settings

# System Report

The System Report page gives you a breakdown of some of the Rundeck server's system statistics and information:

System Report Page
System Report Page

This information is also available via the API: API > System Info

# Log Storage

Details coming soon.

See Logstore

# Plugins

Rundeck is built on a pluggable core. Use these menus to find, install, and manage the plugins on your Rundeck instance.

# Find Plugins

Search plugins from the online Rundeck plugin repository.

# Installed Plugins

See what plugins you have today.

# Upload Plugin

Did you use our Developer Docs to write your own plugin? Upload it here to use it on your instance.

# Password Utility

# Users

This section is where you can see a summary of User accounts and, with Enterprise, manage local user accounts with a GUI based editor.

More details about the Users section can be found here.

# Licenses

This page lists the Rundeck and third party library licenses.