Skip to content

Configuration Properties Reference ​

Directories ​

PropertyDefaultDescription
dir.appdataappdataApplication data directory
dir.tempdata${dir.appdata}/tempTemporary data directory

Network ports ​

PropertyDefaultDescription
http.port8080HTTP port (status page, webstart.jnlp and the signed client jars)
https.port8443HTTPS port (REST API, Administrator)
http.host0.0.0.0HTTP bind address
https.host0.0.0.0HTTPS bind address
http.contextpath/Web server context path

TLS / SSL ​

PropertyDefaultDescription
https.client.protocolsTLSv1.3,TLSv1.2Client TLS protocol versions
https.server.protocolsTLSv1.3,TLSv1.2,SSLv2HelloServer TLS protocol versions
https.ciphersuites(the list in the shipped file)Comma-separated cipher suites
https.ephemeraldhkeysize2048Ephemeral DH key size

Keystore ​

PropertyDefaultDescription
keystore.path${dir.appdata}/keystore.jksKeystore file path
keystore.storepass81uWxplDtBKeystore password. Replaced with a generated value on first start, when no keystore file exists and both passwords still have the shipped value
keystore.keypass81uWxplDtBKey password. Replaced the same way as keystore.storepass
keystore.typeJCEKSKeystore type

Database ​

PropertyDefaultDescription
databasederbyDatabase type: derby, mysql, postgres, oracle, sqlserver
database.url(Derby embedded)JDBC connection URL
database.driver(none)JDBC driver class override (e.g. com.microsoft.sqlserver.jdbc.SQLServerDriver)
database.username(empty)Database username
database.password(empty)Database password
database.max-connections20Read/write connection pool size
database-readonly.max-connections20Read-only connection pool size. When the key is absent, the server writes database-readonly.max-connections = 20 into the file at first start
database.enable-read-write-splittrueEnable separate read-only pool. When the key is absent, the split is on and the server writes database.enable-read-write-split = true into the file at first start
database.poolHikariCPConnection pool type: HikariCP or DBCP
database.write-pool-cachefalseUse the read/write pool for internal caches instead of the read-only pool
database.connection.maxretry2Startup connection retry attempts
database.connection.retrywaitinmilliseconds10000Wait between retries (ms)

Read-only pool override ​

PropertyDefaultDescription
database-readonly(same as primary)Read-only database type
database-readonly.pool(same as primary)Read-only pool type
database-readonly.url(same as primary)Read-only JDBC URL
database-readonly.driver(same as primary)Read-only JDBC driver class override
database-readonly.username(same as primary)Read-only username
database-readonly.password(same as primary)Read-only password

Password policy ​

PropertyDefaultDescription
password.minlength15Minimum password length
password.minupper0Minimum uppercase characters
password.minlower0Minimum lowercase characters
password.minnumeric0Minimum numeric characters
password.minspecial0Minimum special characters
password.retrylimit100Failed attempts before lockout (0 = no lockout)
password.lockoutperiod1Lockout duration in hours (0 = no lockout, even when password.retrylimit is set)
password.expiration0Days until expiration (0 = never)
password.graceperiod0Days a user may still log in after the password expires (0 = unlimited, -1 = no grace period)
password.reuseperiod0Days before a previous password may be reused (0 = always allow, -1 = never)
password.reuselimit0Times a previous password may be reused (0 = no limit, -1 = never)

These are the values conf/mirth.properties ships with. A password.* key that is absent from the file is read as 0, so deleting password.minlength, password.retrylimit or password.lockoutperiod turns that rule off.

Server behavior ​

PropertyDefaultDescription
server.startupdeploytrueAuto-deploy channels on startup
server.includecustomlibfalseInclude custom-lib/ on classpath
server.url(empty)Server URL (auto-detected if empty)
server.initialadminpassword(empty)Password for the admin user, applied only when the database is first created. When blank, a random password is generated and written to the log once. See Initial admin password
server.id.ephemeralfalseGenerate a new server ID on every startup

API security ​

PropertyDefaultDescription
server.api.require-requested-withtrueRequire X-Requested-With header (protects against CSRF)
server.api.accesscontrolalloworigin*CORS allowed origins
server.api.accesscontrolallowcredentialsfalseCORS allow credentials
server.api.accesscontrolallowmethodsGET, POST, DELETE, PUTCORS allowed methods
server.api.accesscontrolallowheadersContent-TypeCORS allowed headers
server.api.accesscontrolexposeheaders(empty)CORS exposed headers
server.api.accesscontrolmaxage(empty)CORS preflight cache (seconds)
server.api.contentsecuritypolicyframe-ancestors 'none'Content-Security-Policy header value
server.api.xframeoptionsDENYX-Frame-Options header value
http.stricttransportsecuritytrueEnable Strict-Transport-Security header

Session management ​

PropertyDefaultDescription
server.api.sessioncachedefaultSession cache strategy (default or none)
server.api.sessionmaxinactiveinterval259200Maximum idle time of an API session in seconds (minimum 60)
server.api.sessionstorefalseStore session data in the database
server.api.sessionstoretablesessiondataDatabase table name for session storage (only used when server.api.sessionstore is true)

JavaScript engine ​

PropertyDefaultDescription
rhino.languageversiones6Rhino JS language version (1.0-1.8, es6, default)
rhino.optimizationlevel-1Rhino optimization level (-1 = interpretive, 0-9 = compiled with increasing optimization)

Administrator client ​

PropertyDefaultDescription
administrator.maxheapsize512mMax JVM heap for the Administrator

Configuration Map ​

PropertyDefaultDescription
configurationmap.path${dir.appdata}/configuration.propertiesConfiguration map file location

Encryption and password hashing ​

None of these keys ship in mirth.properties. The server reads them when added, and uses the defaults below when they are absent.

PropertyDefaultDescription
encryption.export0Encrypt exported channels and files (0 = off, 1 = on)
encryption.properties0Encrypt database.password in this file on next startup (0 = off, 1 = on)
encryption.algorithmAES/CBC/PKCS5PaddingSymmetric encryption algorithm, including mode and padding
encryption.keylength128Encryption key length
encryption.charsetUTF-8Character set used when encrypting
encryption.fallback.algorithmAESFallback symmetric encryption algorithm
encryption.fallback.charsetUTF-8Fallback character set
security.providerorg.bouncycastle.jce.provider.BouncyCastleProviderSecurity provider class
digest.algorithmPBKDF2WithHmacSHA256Password hash algorithm
digest.saltsizeinbytes8Salt size in bytes
digest.iterations600000Hash iterations
digest.usepbe1Derive the hash with a password-based key derivation function (0 = off, 1 = on)
digest.keysizeinbits256Derived key size in bits
digest.fallback.algorithmSHA256Fallback password hash algorithm
digest.fallback.saltsizeinbytes8Fallback salt size in bytes
digest.fallback.iterations1000Fallback hash iterations
digest.fallback.usepbe0Fallback uses a password-based key derivation function (0 = off, 1 = on)
digest.fallback.keysizeinbits256Fallback derived key size in bits

Advanced ​

None of these keys ship in mirth.properties. The server reads them when added, and uses the defaults below when they are absent.

PropertyDefaultDescription
codebase.webstart.url(built from the request's scheme, host, port and context path)Base URL written into the Administrator launch file
donkey.statsupdateinterval1000Interval in milliseconds for updating channel statistics
server.startuplocksleep0Milliseconds to wait at startup when another server's startup lock is found in the database. 0 skips the check
server.api.bypassword(empty)Base64-encoded bypass password for the REST API
configurationmap.locationfileConfiguration map storage location (file or database)
xstream.denytypes(empty)Comma-separated list of class names to deny in XStream deserialization
xstream.allowtypes(empty)Comma-separated list of class names to allow in XStream deserialization
xstream.allowtypehierarchies(empty)Comma-separated list of class hierarchies to allow in XStream deserialization

Version ​

PropertyDefaultDescription
version4.7.0The engine version that last migrated this file. The server reads it at startup to decide which configuration migrations to run. Do not change it