diff --git a/CHANGELOG.md b/CHANGELOG.md
index 6861b2c9..a33668e7 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -4,6 +4,30 @@ All notable changes to this project will be documented in this file.
 Each new release typically also includes the latest modulesync defaults.
 These should not affect the functionality of the module.
 
+## [v5.1.0](https://github.com/voxpupuli/puppet-jira/tree/v5.1.0) (2021-08-20)
+
+[Full Changelog](https://github.com/voxpupuli/puppet-jira/compare/v5.0.1...v5.1.0)
+
+**Implemented enhancements:**
+
+- Configure recommended JDBC connection-properties by default for PostgreSQL databases [\#381](https://github.com/voxpupuli/puppet-jira/pull/381) ([oranenj](https://github.com/oranenj))
+- Allow managing installation and home directory modes and enforce installdir permissions by default [\#378](https://github.com/voxpupuli/puppet-jira/pull/378) ([oranenj](https://github.com/oranenj))
+
+**Fixed bugs:**
+
+- use variable instead of literal in server.xml [\#385](https://github.com/voxpupuli/puppet-jira/pull/385) ([dacron](https://github.com/dacron))
+
+**Closed issues:**
+
+- connection-settings parameter in dbconfig.xml template should be connection-properties instead [\#380](https://github.com/voxpupuli/puppet-jira/issues/380)
+- JIRA will not start if the installation directory mode is missing o+x [\#377](https://github.com/voxpupuli/puppet-jira/issues/377)
+
+**Merged pull requests:**
+
+- switch from camptocamp/systemd to voxpupuli/systemd [\#386](https://github.com/voxpupuli/puppet-jira/pull/386) ([bastelfreak](https://github.com/bastelfreak))
+- Extend the version check to the tailored jira servicedesk version [\#383](https://github.com/voxpupuli/puppet-jira/pull/383) ([diLLec](https://github.com/diLLec))
+- Add note about RHEL 8 and SELinux and clean up a bit [\#379](https://github.com/voxpupuli/puppet-jira/pull/379) ([oranenj](https://github.com/oranenj))
+
 ## [v5.0.1](https://github.com/voxpupuli/puppet-jira/tree/v5.0.1) (2021-04-23)
 
 [Full Changelog](https://github.com/voxpupuli/puppet-jira/compare/v5.0.0...v5.0.1)
diff --git a/REFERENCE.md b/REFERENCE.md
index 5bf6a9d6..43d7f705 100644
--- a/REFERENCE.md
+++ b/REFERENCE.md
@@ -64,6 +64,10 @@ The following parameters are available in the `jira` class:
 * [`manage_user`](#manage_user)
 * [`user`](#user)
 * [`group`](#group)
+* [`installdir_owner`](#installdir_owner)
+* [`installdir_group`](#installdir_group)
+* [`installdir_mode`](#installdir_mode)
+* [`homedir_mode`](#homedir_mode)
 * [`uid`](#uid)
 * [`gid`](#gid)
 * [`shell`](#shell)
@@ -180,7 +184,7 @@ Default value: `'8.13.5'`
 
 ##### <a name="product"></a>`product`
 
-Data type: `String`
+Data type: `String[1]`
 
 Atlassian product to install.
 
@@ -226,6 +230,38 @@ Group that the service will run as
 
 Default value: `'jira'`
 
+##### <a name="installdir_owner"></a>`installdir_owner`
+
+Data type: `String[1]`
+
+The owner of the installation directory.
+
+Default value: `'root'`
+
+##### <a name="installdir_group"></a>`installdir_group`
+
+Data type: `String[1]`
+
+The group of the installation directory.
+
+Default value: `'root'`
+
+##### <a name="installdir_mode"></a>`installdir_mode`
+
+Data type: `Stdlib::Filemode`
+
+The permissions of the installation directory. Note that the JIRA service user must have at least execute permission on the directory.
+
+Default value: `'0755'`
+
+##### <a name="homedir_mode"></a>`homedir_mode`
+
+Data type: `Optional[Stdlib::Filemode]`
+
+The permissions of the service user's home directory, where JIRA's data will reside
+
+Default value: ``undef``
+
 ##### <a name="uid"></a>`uid`
 
 Data type: `Optional[Integer[0]]`
@@ -373,7 +409,7 @@ Default value: ``undef``
 
 ##### <a name="dbschema"></a>`dbschema`
 
-Data type: `Any`
+Data type: `Optional[String[1]]`
 
 The database schema, if applicable. Defaults to 'public' with PostgreSQL
 
@@ -391,7 +427,9 @@ Default value: ``undef``
 
 Data type: `Optional[String]`
 
-Configures JDBC connection settings
+Configures additional JDBC connection properties in dbconfig.xml
+For PostgreSQL, a default value of "tcpKeepAlive=true;socketTimeout=240" will be used
+See https://confluence.atlassian.com/jirakb/connection-problems-to-postgresql-result-in-stuck-threads-in-jira-1047534091.html
 
 Default value: ``undef``
 
diff --git a/metadata.json b/metadata.json
index fb2c53b9..1852f227 100644
--- a/metadata.json
+++ b/metadata.json
@@ -1,6 +1,6 @@
 {
   "name": "puppet-jira",
-  "version": "5.0.2-rc0",
+  "version": "5.1.0",
   "author": "Vox Pupuli",
   "summary": "Module to install, configure and manage Atlassian Jira",
   "license": "Apache-2.0",