Settings changes
You don't need to edit settings.yml by hand to upgrade. The server updates it on every start, keeps your values and adds new settings with their defaults. If the file has fewer than 31 lines, the server saves it as a .bak and starts from the defaults, so put short overrides in custom_settings.yml or environment variables instead. See settings.yml.
Environment variables still override the file. A variable for a removed setting does nothing.
Removed and renamed settings#
| V1 setting | Now |
|---|---|
enterpriseEdition.* |
premium.*, moved automatically |
premium.proFeatures.CustomMetadata.* |
premium.proFeatures.customMetadata.*, moved automatically |
premium.proFeatures.SSOAutoLogin |
security.ssoAutoLogin, moved automatically |
ui.appName, ui.homeDescription |
Removed. ui.appNameNavbar sets the browser tab title and the issuer name in authenticator apps. The home description has no replacement. |
security.jwt.enabled, keyCleanup, keyRetentionDays, secureCookie |
Removed. Key cleanup is now security.jwt.enableKeyCleanup (default true). Sign-in lifetimes are security.jwt.tokenExpiryMinutes (default 1440) and desktopTokenExpiryMinutes (default 43200, for the desktop app). |
security.csrfDisabled |
Removed |
pdf-organizer in endpoints.toRemove |
rearrange-pages. Change it yourself, or the page reordering tools come back. |
storage.signing.userListScope |
Removed in 3.x |
Changed defaults#
These only affect a new settings file. An upgraded file keeps your values.
security.enableLoginis nowtrue.system.showUpdateandsystem.showUpdateOnlyAdminare nowtrue.system.defaultLocaleis now empty, which uses the browser language. It wasen-US.storage.sharing.enabledis nowtrue.
New settings to review#
| Setting | Why it matters |
|---|---|
system.backendUrl, system.frontendUrl |
backendUrl is required for SSO callbacks. frontendUrl is used in invite and share links and when connecting to Stirling Cloud. See OAuth2 / OIDC single sign-on. |
system.corsAllowedOrigins |
Left empty, it allows every origin. List your own origins to restrict it. |
security.xFrameOptions |
With login on, the default DENY stops other sites embedding Stirling PDF. |
mail.enableInvites |
Invite users by email. Needs mail.enabled and login. See Sign-in and security. |
security.validation, security.timestamp, system.serverCertificate |
Signature checking, timestamp servers and the server signing certificate. See Signing certificates and trust. |
security.honorOwnerPasswords, security.blockSignedPdfEdits |
PDF permissions and signed PDFs. See PDF permissions. |
security.scimToken, security.scimDeleteRemovesUser |
SCIM user provisioning. See SCIM. |
security.oauth2.redirectBaseUrl, security.saml2.redirectBaseUrl |
Public URL for SSO callbacks behind a proxy. |
system.setupCompleted |
First-run setup wizard. Added as true on upgrade, so upgraded servers skip it. |
system.maxImageMegapixels, system.maxPdfaConversionPages |
See Processing limits. |
system.enableFeedback |
Feedback button. |
ui.defaultToolPanelMode, ui.defaultStartupView |
Default tool picker mode and startup view for users. |
premium.proFeatures.microsoft |
OneDrive and SharePoint. See OneDrive and SharePoint. |
storage (File storage and sharing) is new and on by default when login is on.
toolRecommendations is new and on by default. With login on, it records which tools each user runs, in your own database.