The application element defines settings for the web services and the portal page. Some of these changes might require a server restart to take effect.

The web services element defines settings for the web service endpoints.

The portal element defines settings for the portal page of the server.

The bridges element defines settings for the bridges (to other applications) used by the server. Such bridges are mostly used, to provide the Converter web service with instruments for a native and more accurate PDF conversion of specific file formats.

Important: Be aware, that activating such a bridge requires the application to be installed and correctly configured on the server side. (Refer to the user manual for further information.)

Defines the settings for the MS Office Bridge. The Office Bridge can be used as an alternative (to the built-in conversion) for converting Office documents. The Office Bridge requires a local installation of MS Office on the server and works only on Windows.

Defines the settings for the SharePoint Bridge. The SharePoint Bridge can be used as an alternative (to the built-in conversion) for converting Office documents. The SharePoint Bridge uses SharePoint Online and therefore requires the corresponding Microsoft 365 service and a registered application on the Microsoft identity platform

Defines the settings for the Chromium bridge. The Chromium bridge is used for converting emails and HTML documents.

Defines the license to be used for the server.

Defines the global keystore used by the server. This keystore is used to store globally available certificates (e.g. for usage in the signature web service).

Defines a TSA (Time Stamp Authority which supports RFC3161) that shall be used by the server (e.g. when signing documents).

Defines proxy servers that shall be known to and used by the server to access external resources.

When enabled, proxy settings are automatically read from the operating system instead of using manually configured proxies.

Supported sources:

Windows: System proxy settings (Internet Settings via Java ProxySelector)
Linux: Environment variables (HTTP_PROXY, HTTPS_PROXY, NO_PROXY)
All platforms: Java system properties (http.proxyHost, http.proxyPort, etc.)

Important:

When useSystemProxies is enabled, all manually configured proxy entries in this section are ignored. This is an exclusive setting - either system proxies OR manual proxies are used, not both.
To read the settings from the Windows registry, the JVM option -Djava.net.useSystemProxies=true must be set.

Limitations: PAC (Proxy Auto-Config) files and WPAD (Web Proxy Auto-Discovery) are not supported. Only basic proxy configurations (host, port, bypass list) are read from the system.

Defines the license to be used for the server.

License key. Divided into five parts, each part delimited by a minus sign. Each part has six characters.

Name of the licensee. Is used in conjunction with the license key. Notation is important.

Defines a set of options for all web services.

If enabled, then the web service is activated.

Number of parallel instances (threads) for the web service. Defines the number of requests that can be executed in parallel before requests are queued.

Maximum allowed time in seconds for the execution of a web service request (job) before the request is canceled. If the time has expired, the execution is aborted and an error code is returned.

Maximum number of waiting requests, before new requests are rejected. If there are more requests than free instances, they are placed in the queue. If this maximum value is reached, further requests are rejected directly. This setting only applies if queueMode is set to MANUAL.

Defines a set of options specific for the "Converter" web service.

Sets the base path (including subfolders) of the server from which to retrieve installed fonts.

If no value is specified, then the default font directories (including subfolders) of the respective operating system are used. Under Windows this is usually C:\Windows\Fonts and under Linux /usr/share/fonts/truetype.

Note: On Linux, the home directory of the user under which the server is running is also always used in addition. The environment variable user.home with the subdirectory .fonts is used.

Important: This setting is supported only by the built-in document converter OutsideIn.

Sets the default font to be used if the original font was not found and no matching character (for representation) was found in any other font with a similar font family or characteristic. Therefore, a font should be used that has the widest possible coverage of characters, especially in the Unicode range.

Note: If no font is specified, then the server tries to find a suitable font (such as "Arial Unicode MS" or "Go Noto Current"). If these fonts are not available, then the respective default font of the operating system (under Windows "Arial" and under Linux "DejaVu Sans") is used. If these are not available either, then a corresponding message appears on the server console (or in the logs).

Important: This setting is supported only by the built-in document converter OutsideIn.

Defines a set of options specific for the "OCR" web service.

Defines a set of options specific for the "Barcode" web service.

Defines a set of options specific for the "URL Converter" web service.

Sets a timeout in seconds, that shall be used for the HTTP request to get the URL.

Sets the text for the user agent to send to the destination server from which the URL is to be retrieved.

Defines a set of options specific for the "Signature" web service.

Defines a set of options specific for the "Toolbox" web service.

Defines a set of options specific for the "PDFA" web service.

Sets the base path of the server from which to retrieve installed fonts.

Defines settings for the global keystore used by the server. This keystore is used to store globally available certificates (e.g. for usage in the signature web service).

The format of the keystore file.

NONE = Keystore not defined.
JKS = A Java keystore (file based with an extension like ".jks").
PKCS11 = A PKCS11 keystore (Smart cards, USB keys/token and hardware security modules (HSMs)).
PKCS12 = A PKCS12 keystore (file based with the extensions like ".p12" or ".pfx").

The password required to access the keystore.

Defines information about one entry of a keystore.

The alias under which the keystore entry was saved.

The password of the keystore entry.

Defines filters for the certificates used from the keystore.

Defines a filter pattern that allows the use of '*' and '?' wildcards.

Defines a TSA (Time Stamp Authority which supports RFC3161) that shall be used by the server.

The URL where the TSA can be reached.

The username required for authentication with the TSA.

The password required for authentication with the TSA.

The hashing algorithm used to check the validity of the timestamp.

When set to true the SharePoint Online bridge shall be enabled.

Defines settings specific for the MS Word application in the office bridge.

Defines settings specific for the MS Excel application in the office bridge.

Defines settings specific for the MS PowerPoint application in the office bridge.

Defines settings specific for the MS Visio application in the office bridge.

If enabled, then the MS Office bridge is activated.

If enabled, then MS Word is usable via the Office bridge.

If enabled, then MS Excel is usable via the Office bridge.

If enabled, then MS PowerPoint is usable via the Office bridge.

If enabled, then MS Visio is usable via the Office bridge.

If enabled, then all debug messages of the Office Bridge will be visible in the Windows application "SysInternals DebugView"

Defines the settings for the Chromium bridge. The Chromium bridge is used for converting emails and HTML documents.

If enabled, then the Chromium bridge is activated.

The port on which Chromium should listen for requests.

Sets a custom base path for the Chromium application.

The IP address on which Chromium should be reachable.

Sets this option whether the Chromium process should run in a sandbox or not.

Important: Be aware that running Chromium outside a sandbox can be a security risk. Proceed with caution!

Sets the headless mode (for unattended environments) when the Chromium instance starts.

Allows you to define a list of command line switches that will be passed to the Chromium process. These values must be valid and fully declared switches that are passed unchanged to the Chromium process. Switches passed in this way have priority over all other defined switches.

Defines a single command line switch for the Chromium process. This switch consists of a name for the switch and an associated value.

Sets the name of the Chromium command line switch. The name must be spelled correctly (without "--" and in correct upper/lower case), because it will be used unchanged.

Defines the value of the Chromium command line switch. The value for the switch is used unchanged and must be escaped properly.

Sets the mode for the command line switch.

Defines the operation mode for the command line switch.

ADD = add the command line switch
REMOVE = remove the command line switch

Defines the different headless modes of the Chromium instance.

NEW = Uses the same code base for the Chromium headless instance as the normal non-headless browser.
OLD = Uses the old code base for the Chromium headless instance, which is different from the non-headless browser

Defines settings for the user interface of the portal.

Specifies whether the portal page should display the maximum number of up-loadable files on the screen.

Defines whether the portal page should display the maximum available disk space on the screen.

Defines which portal functions are enabled or disabled.

When set to true the portal page shall display help and info messages.

If disabled, then the URL to PDF conversion is deactivated.

If disabled, then the "upload file" dialog is deactivated.

If deactivated, then the "convert document" dialog is deactivated.

If disabled, then the "rename document" dialog is deactivated.

If disabled, then the "OCR conversion" dialog is deactivated.

If disabled, then the "PDF/A conversion" dialog is deactivated.

If disabled, then the "rotate pages" dialog is deactivated.

If disabled, then the "delete pages" dialog is deactivated.

If disabled, then the "extract pages" dialog is deactivated.

If disabled, then the "extract content" dialog is deactivated.

If disabled, then the "add watermark" dialog is deactivated.

If disabled, then the "export as image" dialog is deactivated.

If disabled, then the "change document settings" dialog is deactivated.

If disabled, the "change document view" dialog is deactivated.

If disabled, then the "encrypt document" dialog is deactivated.

If disabled, then the "print document" dialog is deactivated.

If disabled, then the "merge document" dialog is deactivated.

If disabled, then the "split document" dialog is deactivated.

If disabled, then the "sign document" dialog is deactivated.

If disabled, then the "create Barcode" dialog is deactivated.

If disabled, then the "detect Barcode" dialog is deactivated.

If disabled, then the "edit forms" dialog is deactivated.

If disabled, then the "edit attachment" dialog is deactivated.

If disabled, then the "edit annotation" dialog is deactivated.

If disabled, then the "edit background" dialog is deactivated.

If disabled, then the "edit transitions" dialog is deactivated.

If disabled, then the "edit boxes" dialog is deactivated.

If disabled, then the "edit header/footer" dialog is deactivated.

If disabled, then the "move pages" dialog is deactivated.

If disabled, then the "edit outline" dialog is deactivated.

If disabled, then the "redact" dialog is deactivated.

If disabled, then the "sanitize" dialog is deactivated.

If disabled, then the "portfolio" dialog is deactivated.

If disabled, then the "scale pages" dialog is deactivated.

If disabled, then the "compress" dialog is deactivated.

If disabled, then the "transcribe document" dialog is deactivated.

Defines whether the portal displays a news page and where the content is loaded from.

Interval in seconds at which the content should be reloaded.

Defines a source for the entries in the "news panel" of the portal page".

URL from which to load the content for the "news panel".

Defines a proxy server that shall be known to and used by the server to access external resources.

A list of host entries for which the proxy should be bypassed. Wildcards (`*`) are supported for pattern matching.

The scheme to access the proxy server (currently only "http" or "https" are allowed).

The address of the proxy server.

The port on which the proxy listens.

The name of the user required to authenticate with the proxy server.

The password of the user required to authenticate with the proxy server.

When enabled, the proxy will be bypassed for local addresses such as localhost, 127.0.0.1, [::1], and addresses without a dot (e.g., "intranet").

Enables or disables this proxy configuration. When disabled, the proxy will not be used even if configured.

A list of host entries for which the proxy should be bypassed. Wildcards ('*') are supported for pattern matching.

A single host entry for which the proxy should be bypassed. Wildcards ('*') are supported for pattern matching.

Defines settings specific for the MS Visio application in the office bridge.

If this option is enabled, the Office Bridge application is started in test mode when the server is initialized, which provides advanced debugging information.

The time in seconds to wait for the OLE server to start during initialization.

The time in seconds to wait for the OLE server to terminate at shutdown.

The minimum time frame provided for the execution of an operation with the Office bridge.

The portal element defines settings for the portal page of the server.

Defines which portal functions are enabled or disabled.

Defines settings for the user interface of the portal.

Defines whether the portal displays a news page and where the content is loaded from.

Defines global settings for the web service calls made from the portal page.

Defines which settings apply for authentication to the portal.

Defines global settings for the web service calls made from the portal page.

Defines the profile whose rules web services have to check before they can come to execution. These profiles define a set of rules concerning the validity of signatures. A web service whose execution for a given signed document would violate the rule set selected here should instead abort with an appropriate error code.

adobeRestrictions = Only those changes are allowed that are enabled by the included signatures. This follows the specifications given by Adobe.
generalEditRestrictions = All changes to signed documents are prohibited, even those that might be allowed according to the included signatures.
noEditRestrictions = Editing of signed documents is not restricted and all changes are allowed. (By doing this, you accept the possible invalidation of included signatures.)

Important: You can find further explanations of these profiles in the chapter "Signature Validation".

Sets the profile for automatic document compression and thus defines whether compression should be applied when saving.

always = PDF documents should always be compressed when saved.
never = PDF documents should not be automatically compressed.
recompress = PDF documents should only be compressed automatically if they were already compressed previously.

Defines which settings apply for authentication to the portal.

Defines the timeout settings related to authentication and session.

Defines whether the login for the front end portal page is available or not. This has no effect on the admin page, which is always available.

If enabled, then anonymous login (without username and password) are allowed on the front end portal page. This has no effect on the admin page, which always denies anonymous access.

Defines the timeout settings related to authentication and session.

Defines the time in seconds after which a user should be considered inactive if no activity is detected in the portal. If the value is '0', then the detection is disabled, i.e. the user is never inactive.

Defines the time in seconds before the access token expires at which an auto-refresh is performed. The auto-refresh prevents the session from expiring and the access token from becoming unusable. If the user is considered inactive, then a dialog is displayed before the auto-refresh is executed. If the value is '0', then the auto-refresh is disabled, i.e. the session ends when the access token expires.

Defines the settings for the registered application on the Microsoft identity platform for access to the SharePoint Online site

The ID of the application that was assigned during creation

The id of the tenant to which the application belongs

The secret that was generated for the application

Defines the name of the Sharepoint Online site that is used for document conversion. Access to the site must be configured as a registered application on the Microsoft identity platform

The name of the site to be used for converting the documents

Defines how the size of the queue is determined.

With AUTO, it is calculated automatically by the server based on the number of configured instances.