{"id":49432,"date":"2025-05-22T05:08:57","date_gmt":"2025-05-22T05:08:57","guid":{"rendered":"https:\/\/www.devopsschool.com\/blog\/?p=49432"},"modified":"2025-05-22T05:08:57","modified_gmt":"2025-05-22T05:08:57","slug":"rundeck-configuration-options-rundeck-config-properties","status":"publish","type":"post","link":"https:\/\/www.devopsschool.com\/blog\/rundeck-configuration-options-rundeck-config-properties\/","title":{"rendered":"Rundeck Configuration Options – rundeck-config.properties"},"content":{"rendered":"\n
\n\n\n\n

\ud83d\udd27 Rundeck Configuration Options<\/h2>\n\n\n\n

1. General Settings<\/strong><\/h3>\n\n\n\n
Property<\/th>Description<\/th>Example<\/th><\/tr><\/thead>
loglevel.default<\/code><\/td>Sets the default log level for jobs. Options: ERROR<\/code>, WARN<\/code>, INFO<\/code>, VERBOSE<\/code>, DEBUG<\/code>.<\/td>INFO<\/code><\/td><\/tr>
rdeck.base<\/code><\/td>Specifies the base directory for Rundeck.<\/td>\/var\/lib\/rundeck<\/code><\/td><\/tr>
server.servlet.context-path<\/code><\/td>Defines the web context path.<\/td>\/rundeck<\/code><\/td><\/tr>
server.port<\/code><\/td>Sets the HTTP port for the server.<\/td>4440<\/code><\/td><\/tr>
server.address<\/code><\/td>Specifies the address\/hostname to listen on.<\/td>0.0.0.0<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

2. Security Settings<\/strong><\/h3>\n\n\n\n
Property<\/th>Description<\/th>Example<\/th><\/tr><\/thead>
rundeck.security.useHMacRequestTokens<\/code><\/td>Enables\/disables HMAC-based request tokens.<\/td>true<\/code><\/td><\/tr>
rundeck.security.apiCookieAccess.enabled<\/code><\/td>Allows API access via session cookies.<\/td>true<\/code><\/td><\/tr>
rundeck.api.tokens.duration.max<\/code><\/td>Sets the maximum duration for API tokens.<\/td>30d<\/code><\/td><\/tr>
rundeck.security.csrf.referer.filterMethod<\/code><\/td>Sets HTTP methods to filter based on Referer header. Options: NONE<\/code>, POST<\/code>, *<\/code>.<\/td>NONE<\/code><\/td><\/tr>
rundeck.security.csrf.referer.allowApi<\/code><\/td>Allows API requests without matching Referer header.<\/td>true<\/code><\/td><\/tr>
rundeck.security.csrf.referer.requireHttps<\/code><\/td>Requires Referer header to be from HTTPS version of server URL.<\/td>true<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

3. Execution Settings<\/strong><\/h3>\n\n\n\n
Property<\/th>Description<\/th>Example<\/th><\/tr><\/thead>
rundeck.executionMode<\/code><\/td>Sets the execution mode. Options: active<\/code>, passive<\/code>.<\/td>active<\/code><\/td><\/tr>
rundeck.localExecutor.disabled<\/code><\/td>Disables the local executor plugin.<\/td>false<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

4. Database Configuration<\/strong><\/h3>\n\n\n\n
Property<\/th>Description<\/th>Example<\/th><\/tr><\/thead>
dataSource.url<\/code><\/td>JDBC URL for the database connection.<\/td>jdbc:h2:file:\/var\/lib\/rundeck\/data\/rundeckdb<\/code><\/td><\/tr>
dataSource.username<\/code><\/td>Database username.<\/td>rundeckuser<\/code><\/td><\/tr>
dataSource.password<\/code><\/td>Database password.<\/td>rundeckpassword<\/code><\/td><\/tr>
dataSource.driverClassName<\/code><\/td>JDBC driver class name.<\/td>org.h2.Driver<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

5. GUI Customization<\/strong><\/h3>\n\n\n\n
Property<\/th>Description<\/th>Example<\/th><\/tr><\/thead>
rundeck.gui.title<\/code><\/td>Sets the title displayed in the application header.<\/td>Rundeck<\/code><\/td><\/tr>
rundeck.gui.instanceName<\/code><\/td>Sets the instance name displayed in the GUI.<\/td>Production Rundeck<\/code><\/td><\/tr>
rundeck.gui.logo<\/code><\/td>Specifies the logo file to use.<\/td>rundeck.png<\/code><\/td><\/tr>
rundeck.gui.login.welcome<\/code><\/td>Sets the welcome message on the login page.<\/td>Welcome to Rundeck<\/code><\/td><\/tr>
rundeck.gui.login.footerMessageHtml<\/code><\/td>Sets the footer message on the login page.<\/td><p>Contact support for assistance.<\/p><\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

6. Logging Configuration<\/strong><\/h3>\n\n\n\n
Property<\/th>Description<\/th>Example<\/th><\/tr><\/thead>
rundeck.execution.logs.streamingWriterPlugins<\/code><\/td>Comma-separated list of streaming log writer plugins.<\/td>plugin1,plugin2<\/code><\/td><\/tr>
rundeck.execution.logs.streamingReaderPlugin<\/code><\/td>Specifies the streaming log reader plugin.<\/td>plugin1<\/code><\/td><\/tr>
rundeck.execution.logs.localFileStorageEnabled<\/code><\/td>Enables\/disables local file storage for logs.<\/td>true<\/code><\/td><\/tr>
rundeck.execution.logs.fileStoragePlugin<\/code><\/td>Specifies the file storage plugin for execution logs.<\/td>plugin1<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

7. Storage Configuration<\/strong><\/h3>\n\n\n\n
Property<\/th>Description<\/th>Example<\/th><\/tr><\/thead>
rundeck.storage.provider.1.type<\/code><\/td>Sets the storage provider type.<\/td>file<\/code><\/td><\/tr>
rundeck.storage.provider.1.path<\/code><\/td>Sets the path within the storage tree.<\/td>\/keys<\/code><\/td><\/tr>
rundeck.storage.provider.1.config.baseDir<\/code><\/td>Sets the base directory for file storage.<\/td>\/var\/lib\/rundeck\/keys<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n

8. Feature Toggles<\/strong><\/h3>\n\n\n\n
Property<\/th>Description<\/th>Example<\/th><\/tr><\/thead>
rundeck.feature.option-values-plugin.enabled<\/code><\/td>Enables the option values plugin feature.<\/td>true<\/code><\/td><\/tr>
rundeck.feature.pagedjoblist.enabled<\/code><\/td>Enables the paged job list UI.<\/td>true<\/code><\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n
\n\n\n\n

Note:<\/strong> This table includes a selection of commonly used configuration options. For a complete list and detailed explanations, please refer to the official Rundeck documentation: Configuration File Reference<\/a>.<\/p>\n\n\n\n

<\/p>\n","protected":false},"excerpt":{"rendered":"

\ud83d\udd27 Rundeck Configuration Options 1. General Settings Property Description Example loglevel.default Sets the default log level for jobs. Options: ERROR, WARN, INFO, VERBOSE, DEBUG. INFO rdeck.base Specifies the base directory… <\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"open","ping_status":"","sticky":false,"template":"","format":"standard","meta":{"_joinchat":[],"footnotes":""},"categories":[2],"tags":[],"class_list":["post-49432","post","type-post","status-publish","format-standard","hentry","category-uncategorised"],"_links":{"self":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49432","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/comments?post=49432"}],"version-history":[{"count":1,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49432\/revisions"}],"predecessor-version":[{"id":49433,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/posts\/49432\/revisions\/49433"}],"wp:attachment":[{"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/media?parent=49432"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/categories?post=49432"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/www.devopsschool.com\/blog\/wp-json\/wp\/v2\/tags?post=49432"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}