Advanced Configuration Reference

Config.ini is a text file located by default in C:\ProgramData\MyQ. This file controls key aspects of Print Server behavior, including communication, job processing, logging, and user access.

You can edit config.ini using Notepad or any other text editor.

Warning: Incorrect values in this file may cause system outages or data loss.

Before You Edit:

Always back up the existing config.ini file.
Only modify parameters supported in your installed version.
Restart the Print Server after saving changes.
Disable any temporary debugging parameters after use.

Only advanced users or system administrators should edit this file. When in doubt, contact support@myq-solution.com.

Example

TEXT

;Print Server configuration
;You must restart the service for the changes to take effect

[General]
;Enabling duplicate email addresses
allowEmailAddressDuplicity=true
;Configuring backups without data compression
backupCompressionLevel=0

[ExtraFeatures]
;Enabling support for eGoldFax and Lotus Domino
eGoldFax=1
lotusDomino=1

[UserSession]
;If the printer is unreachable longer than X seconds, interrupt the session. 
;Jobs that have not been sent to the printer yet, will not be printed. 
;User can print them next time.
printerUnreachableTimeout=90

[General]

This section defines system-wide behaviors for email address duplicity, backup compression, domain mapping, printer conflict resolution, and user interface accessibility features, among others.

Parameter	Version	Default	Description
`allowEmailAddressDuplicity`	10.2+	`false`	Enforcement of unique email addresses. When `true`, multiple users can share the same email address. Values: `true`, `false` Note: If a database with email duplicity is being upgraded, both email values persist and an alert is issued to the log.
`backupCompressionLevel`	8.2+	5	0 - 9 (0 = no compression , 9 = max compression)
`clientJobDataTimeout`	8.2+	90000	Timeout, in milliseconds, specifying the timeout period for the heartbeat from SPS to arrive during client spooling.
`cluster`	8.2+	1	Detects if PS is running in Cluster when starting services. This is used, e.g., for generating HW code in the License plugin. Works in installation key mode only
`dbMaxDeltaOAT`	8.2+	150000	DB health checker: maximum difference between next transaction ID and OAT. If it is bigger, a warning is logged, because it could signal the DB sweep is not being performed.
`dbMaxDeltaOIT`	8.2+	150000	DB health checker: maximum difference between next transaction ID and OIT. If it is bigger, a warning is logged, because it could signal the DB sweep is not being performed.
`dbMaxDeltaOldestSnapshot`	8.2+	100000	DB health checker: maximum difference between next transaction ID and oldest-snapshot. If it is bigger, a warning is logged, because it could signal the DB sweep is not being performed.
`ddiTimeout`	8.2+	360	DDI timeout, in seconds, when DDI is called from Web UI (Printers, Printer Discovery)
`debug`	8.2+	`false`	Enables debug mode. Values: `true`, `false`
`deletePrinterWithSameIP`	8.2+	0	Printer Discovery handling for printers with conflicting IP addresses. Values: 0 (fail with error: "printer with IP address or hostname already exists") 1 (replace current with new)
`domainsMapping`	10.2+	empty	Support for environments where the domain name and NETBIOS name are different. Example value: `domainsMapping="domain1=newdomain2.com, domain2a=newdomain2.cz, domain2b=newdomain2.cz"` …where `domain1` is the NETBIOS name, and `newdomain2.com` is the DNS name, with multiple domain mappings.
`enhancedAccessibility`	8.2+	`false`	Enables improves accessibility mode for Web UI. Values: `true`, `false` Note: For 10.1+, if `true` and no theme is selected, the high contrast theme is the default.

[ExtraFeatures]

This section enables optional and legacy-compatible features, including legacy LDAP and FTP compatibility, and granular debug logging for specific devices.

Parameter	Version	Default	Description
`DelegatesLimit`	8.2+	50	Sets the maximum number of returned user's delegates. Once documenting, mention the maximum recommended delegates. Values: 0, 1
`deleteCards`	8.2+	0	Enables the Delete ID Cards button on the dashboard and the rights to use it. Values: 0, 1
`domainLogin`	8.2+	0	Show domain on login page. Values: 0, 1
`eGoldFax`	10.2+	0	Enables eGoldFax integration. Values: 0, 1
`enableReportSqlFilter`	8.2-10.1	0	Enables the SQL filter for reports. Values: 0, 1
`logDebugSpecificPrinter`	8.2.16+	0	Enables debug logging for individual printers. Use this option to minimize resource utilization when debugging. Values: 0, 1
`lotusDomino`	10.2+	0	Enables support for the legacy Lotus Domino LDAP server. Values: 0, 1
`multipleDomains`	8.2+	0	Enables synchronization of users from multiple domains. Values: 0, 1 Note: Requires user synchronization option Append the domain name to the username.
`registerUserName`	8.2-10.1	0	Enables web user registration based on username and PIN/password. Values: 0, 1
`scanFtpLegacyMode`	8.2+	0	Enables legacy FTP mode as a scan destination. This can be useful if issues arise when using native FTP mode. Values: 0, 1
`scheduleExternalCommand`	8.-10.1	0	Allows to add external command to scheduler. Values: 0, 1

[HttpChecker]

These parameters configure internal health checks performed via HTTP, including timeouts and thresholds. They help identify slow or unresponsive components, and optionally restart the proxy when issues occur.

Parameter	Version	Default	Description
`connectTimeout`	8.2+	10	Timeout for the connect phase (in seconds).
`maxRequestTime`	8.2+	2	Minimal time for success query will be logged as slow (in seconds).
`restart`	10.1+	0	Restarts the HTTP proxy if the HTTP server responds but the HTTP proxy does not. Values: 0, 1
`timeout`	8.2+	20	Timeout for the entire request (in seconds).

[JobAccounting]

These parameters control how printed output is counted for accounting purposes. Define whether output should be measured in physical sheets or logical “clicks” (impressions), including special handling for duplex jobs.

Parameter

Version

Default

Description

duplexInClicks

8.2+

0

Accounting units for simplex and duplex counters:

Values: 0 (sheets), 1 (clicks)

papersInClicks

8.2+

0

Accounting units for paper counters:

Values: 0 (sheets), 1 (clicks)

[JobDeleter]

This section controls how often the system checks for and removes expired print jobs from the queue.

Parameter	Version	Default	Description
`period`	8.2+	3600	How often expired jobs are deleted/canceled (in seconds).

[JobParser]

This section controls how print jobs are analyzed before processing, including some diagnostic options.

Parameter	Version	Default	Description
aliases, e.g., `aliasA4` `aliasB5` `aliasLedger` `aliasLegal`	8.2+	empty	List of custom paper format aliases, as either string names or paper sizes in the form “height x width”, where the width and height are integer numbers defining the paper size in tenths of millimeters. Example: `aliasA4= A4, 2970x2100`
`parameters`	8.2+	empty	MyQJobProcessor.exe supports following command line switches: d (Write debug messages to standard output) c (Check analysis result by rendering) x (Log all exceptions (10.1+)) Example: `parameters=d,c,x`
`threadCount`	8.2+	2	Number of jobs that can be parsed in parallel.
`timeout`	8.2+	300000	Timeout (in milliseconds) for the external job parser to finish. If the time elapses, the external parser process terminates the job's metadata will be not set. The default 5min is enough to parse 4GB PCL6 file. Increase the timeout for larger jobs.

[JobPreview]

This section configures how print job previews are generated and displayed in the user interface, including timeouts, page limits, and custom preview tools for specific printer languages.

Parameter	Version	Default	Description
`jobPreviewPages`	8.2-10.1	5	Maximum number of pages to preview Set to zero (unlimited) to preview all pages. This value is used for the default preview generator only. For an external preview generator, use appropriate command line switches if your tool supports limiting pages.
`jobPreviewTimeout`	8.2-10.1	60	Defines timeout in seconds for the user defined external preview generator (implemented in PrintServerPlugin; C++). The timeout for the Default preview generator is set in [JobParser] `timeOut`.
`pcl5ToPdf_command`	10.1+	empty	Defines a custom tool for generating previews for jobs with PCL5 PDL. This tool is then used for all PDF previews. Custom PDF tools must support at least the %inFile% and %outFile% parameters. Optionally, they can support %pageCount%. Example value: `pcl5ToPdf_command="c:\folder name\pdfTool.bat" %inFile% %outFile% %pages%`
`pcl5ToPdf_removePrescribe`	10.1+	`true`	Controls whether to remove prescribe for preview files generated with a custom PCL5 PDF preview generator.
`pcl6ToPdf_command`	10.1+	empty	Defines a custom tool for generating previews for jobs with PCL6 PDL. This tool is then used for all PDF previews. Custom PDF tools must support at least the %inFile% and %outFile% parameters. Optionally, they can support %pageCount%. Example value: `pcl6ToPdf_command="c:\folder name\pdfTool.bat" %inFile% %outFile% %pages%`
`pcl6ToPdf_removePrescribe`	10.1+	`true`	Controls whether to remove prescribe for preview files generated with a custom PCL6 PDF preview generator.
`psToPdf_command`	10.1+	empty	Defines a custom tool for generating previews for jobs with PS PDL. This tool is then used for all PDF previews. Custom PDF tools must support at least the %inFile% and %outFile% parameters. Optionally, they can support %pageCount%. Example value: `psToPdf_command="c:\folder name\pdfTool.bat" %inFile% %outFile% %pages%`
`psToPdf_removePrescribe`	10.1+	`true`	Controls whether to remove prescribe for preview files generated with a custom PS PDF preview generator.
`uiWaitTimeout`	8.2+	5	Defines the timeout in seconds for which web UI waits for the job preview to be generated. When the timeout is reached, this message appears: The preview is being generated. Try again later. The maximum value is limited by the maximum execution time of a PHP script.

[JobProcessor]

This section configures how the print server prepares jobs for output, including font fallback logic for watermark rendering and compatibility options for controlling printer behavior.

Parameter

Version

Default

Description

watermarkFontPath

8.2+

%WINDOWS_FONT_DIR%/times.ttf,
%MYQ_APP_PATH%/Server/Fonts/AozoraMinchoRegular.ttf,
%MYQ_APP_PATH%/Server/Fonts/android/DroidSansFallbackFull.ttf,
%WINDOWS_FONT_DIR%/malgun.ttf

Comma-separated list of TTF file paths, in descending priority.

Reorder the list of paths to prioritize different scripts (useful for non-European customers).

Note: The system falls back to the next file if a character is not available. If no font file contains the character, the first font is used and a warning is logged.

[JobReleaser]

This section enables job capture for debugging. When activated, the system saves the last job sent to each queue for troubleshooting purposes.

Parameter

Version

Default

Description

captureJob

8.2+

false

Captures job data being sent to a printer and writes it to a file in the Jobs folder. The last job for each queue is stored.

Use only when debugging.

Values: true, false

[Mdc]

This parameter controls the number of concurrent requests from MyQ Desktop Client.

Parameter	Version	Default	Description
`proxyWorkers`	10.2+	8	Maximum concurrent requests coming from MDC.

[MicrosoftUniversalPrint]

This section controls how often the system checks Microsoft Universal Print for new notifications, such as job status updates or errors.

Parameter	Version	Default	Description
`notificationPollingPeriod`	8.2+	30s	How often the server checks for printer notifications, in seconds.

The default notification polling is every 30 seconds, but polling at longer intervals (e.g., 60-120 seconds) can reduce server and network load in large deployments, at a cost of increased latency.

[NSP]

The Non-Session Page (NSP) is a process that periodically checks printers for any changes in the printer counters to detect any attempts to bypass MyQ.

Parameter	Version	Default value	Description
`period`	8.2+	600000	How often the NSP process runs, in milliseconds. The default value is equivalent to 10 minutes.

[OfflineLogin]

This section configures how many user are cached locally on devices for authentication when the main server is unavailable.

Parameter	Version	Default value	Description
`maxUsers`	8.2+	100	Maximum number of users sent to the device.

[PersonalQueues]

These parameters control which print queues are visible to users and how personal queue displays are filtered and organized. For more information, see Personal Queues.

Parameter

Version

Default value

Description

queues

8.2+

empty

Comma separated list of allowed queues for the first queue. Supports the wildcard character %.

Examples:

“Direct” - shows the Direct queue.
“Direct_%” - shows all queues that start with "Direct_"

show

8.2+

1

Set the types of queues that are visible.

Values:

1 (All)
2 (Follow me and delegated)
3 (Direct)

showDirectQueueOnFirstRow

8.2+

empty

Display personal queues with direct type first, with the queues filter is applied to it. From the second row on, only the "show" filter is applied.

Values: 0, 1

[PrinterEvents]

This section defines parameters for monitoring printer supplies, such as toner levels.

Parameter

Version

Default

Description

suppliesUpkeepPeriod

8.2-10.0

1min

How often the supplies manager updates the state of toner level events.

tonerLevelPredicateSustain

8.2-10.0

5min

Configures the toner level event. This specifies for how long the toner level must be below a threshold for the event to occur.

The reverse also applies - events are not triggered immediately because there can be brief spikes in toner level. 

[PrinterIO]

This section defines how the system communicates with printers to retrieve device information, including SNMP object identifiers for reading printer models and specifications.

Parameter	Version	Default	Description
`macAddress`	8.2+	.1.3.6.1.2.1.2.2.1.6.1,.1.3.6.1.2.1.2.2.1.6.2	Specifies the list of OIDs for getting MAC addresses of the printers.
`model`	8.2+	.1.3.6.1.2.1.25.3.2.1.3.1, .1.3.6.1.4.1.11.2.4.3.1.12.1.2.78, .1.3.6.1.2.1.1.1.0	Comma-separated list of SNMP Object Identifiers (OIDs) where the model is read. To use a PJL query, include the special value “pjl”. Example value: `.1.3.6.1.2.1.25.3.2.1.3.1,` `.1.3.6.1.4.1.11.2.4.3.1.12.1.2.78,` `.1.3.6.1.2.1.1.1.0`
`oidDeviceType`	8.2-10.2.12	.1.3.6.1.2.1.25.3.2.1.2	One OID which is used for detecting the type of the device (in Printer Discovery)
`oidDeviceTypePrinter`	8.2-10.2.12	.1.3.6.1.2.1.25.3.1.5	The OID values (separated by comma) which describe printer device (in Printer Discovery)
`printerDiscoveryThreads`	8.2-10.2.12	128	Specifies the number of threads which are used for printer discovery

[PrinterStatusChecker]

This section configures how the print server monitors printer availability and status, including ping attempts, timeouts, and parallel thread limits for reachable and unreachable devices.

Parameter	Version	Default	Description
`errorMaxThreads`	8.2+	16	How many unreachable printers to check in parallel. If the printer is still unreachable, a  check takes, in milliseconds: `pingTimeoutMS` * `pingAttempts`
`errorPeriodMS`	8.2+	30000	How often to check the unreachable printers using ping.
`icmpPing`	8.2+	1	By default MyQ uses the ICMP ping to check, if the printer is on-line. If this is set to 0, the driver specific ping is used instead. In case of the SNMP driver, it uses an SNMP GET request to the OID .1.3.6.1.2.1.1.1.0 (sysDescr).
`okMaxThreads`	8.2+	2	How many connected printers to check in parallel. First with a ping to check connectivity, and then it reads the status via SNMP, or other method depending on the printer driver.
`okPeriodMS`	8.2+	60000	How often to update status of connected printers.
`pingAttempts`	8.2+	3	Number of ping requests sent to the printer. If all fail, printer is unreachable.
`pingTimeoutMS`	8.2+	1000	Ping timeout in milliseconds
`totalCountersPeriod`	8.2+	10min	Period of reading of the total counters. Previously, the value was in milliseconds. From 8.1+ you can use the Duration syntax.

[RateLimit]

These parameters control security throttling with thresholds for failed authorization attempts.

Parameter	Version	Default value	Description
`thresholdCount`	10.2+	10	The number of failed API authorization requests from one IP address that can be made within the threshold, including login on Terminal (PIN, password, card).
`thresholdInterval`	10.2+	300	The interval during for which `thresholdCount` is applied, in seconds. The default is 5 minutes.

The rate limiter cannot be disabled. You can effectively disable by setting values that would be unlikely in practice. For example:

thresholdInterval=1
thresholdCount=9999

[ResourceMonitoring]

These parameters control how the system samples and logs resource usage data for performance monitoring and analysis.

Parameter	Version	Default value	Description
`sampleBatchPeriod`	10.2.13+	10	Period of batching the samples for logging, in minutes.
`sampleGatheringPeriod`	10.2.13+	5	Resource sampling period, in seconds.

[Scan]

This parameter controls the extension format of scanned document filenames.

Parameter

Version

Default value

Description

threeCharExtensions

8.2+

0

Enforce three-character file extensions (e.g. .tif, .jpg).

Values: 0, 1

[Security]

This section defines system-wide security settings for communication protocols and authentication. Use these settings to align the system with your organization's security and compliance requirements.

For detailed guidance, see Advanced Security.

Parameter	Version	Default value	Description
`caValidity`	8.2+	730	CA certificate validity in days.
`kerberosOnly`	10.2.13+	`false`	Forces Integrated Windows Authentication to allow Kerberos auth only. NTLM attempts are denied. Values: `true`, `false`
`sslCipherSuites`	10.2.7+	compatible	Possible values are: compatible - deprecated weaker ciphers allowed strict - no weak ciphers allowed
`sslProtocol`	8.2+	TLS1.2 < 10.2: SSL2	Specifies the minimal security protocol which is used for communication. Possible values: SSL2, SSL3, TLS1, TLS1.1, TLS1.2, TLS1.3 Note: In MyQ 8.2.39+ / 10.1+ this setting also affects Traefik - If SSL2, SSL3, TLS1 -> TLS1 is used for Traefik This parameter affects the configuration of: SMTP IPP LPR Messages (WebSockets) HTTP Router

[SMTPClient]

This section configures how the system connects to an external mail server when sending emails and notifications.

Parameter	Version	Default	Description
`domain`	8.2+	empty	Domain to be used in HELO command.
`timeout`	8.2+	30	PHP mailer SMTP timeout in seconds.

[SMTPServer]

This section controls how the system receives and handles email-related communication, including message size limits, encryption settings, and timeouts.

Parameter

Version

Default value

Description

encryption

8.2+

true

When set to false, the SMPT server does not announce its ability to use encryption. This forces clients to use an unencrypted connection or disconnect.

maxMessageSize

8.2+

47185920

Maximum message size in bytes that the SMTP server can receive. If exceeded, SMTP server returns a 552 error.

Default value is equivalent to 45MB.

0 = unlimited message size (effectively up to the implemented limit, which is 2GB, or 2147483648)

timeout

8.2+

60000

Communication timeout, in milliseconds. Default is equivalent to 60 seconds.

[Supplies]

This section configures how the system monitors supply levels, which affects toner status monitor events, toner replacement prediction events, and detections of toner replacements.

Parameter	Version	Default	Description
`supplyLevelSustainPeriod`	10.1+	5min	Duration for which a supply level must be stable before it is marked as sustained.

[Terminal]

Parameter	Version	Default	Description
`kyoceraLiteDummyJob`	8.2+	1	If true, the Kyocera Embedded Lite terminal sends the "dummy job" to PM Server. If false, an empty filename is sent.
`printedJobTimeOut`	8.2+	1200	Timeout in seconds of locally spooled printed jobs.
`sendCmdAttempts`	8.2+	4	Number of packet retransmission attempts. A retransmission occurs when the terminal does not acknowledge the packet from the server. If all attempts fail, there will the "Terminal is not responding to the command" message in the log.
`term5IdleTimeOutInMS`	8.2+	35000	If the server does not receive any keep-alive packets from the terminal in this time period (in milliseconds), the terminal is considered abandoned and removed from the list of terminals. This value is used for terminals with firmware version equal or greater than 5.

[Testing]

This parameter provides a diagnostic option for UI debugging.

Parameter

Version

Default

Description

disableTranslation

10.1+

0

Rendering of language strings in the user interface.

Values:

0 - Show translated strings

1 - Show translation IDs

Note: Requires debug mode.

[UserSession]

This section defines how user sessions are managed on printing devices, including timeouts, job retry behavior, session recovery, and credit reservation settings.

Parameter	Version	Default	Description
`creditBlockingMaxPages`	8.2+	40	Used when automatic credit reservation is turn on on the account. The "Maximum reserved credit" value is calculated automatically as creditBlockingMaxPages * maxPagePrice. The maxPagePrice is calculated from the price list.
`creditBlockingMinPages`	8.2+	10	Used when the automatic credit reservation is turn on on the account. The "Minimal reserved credit" value is calculated automatically as creditBlockingMinPages * maxPagePrice. The maxPagePrice is calculated from the price list.
`jobSenderConnectTimeOutInMS`	8.2+	30000 ms	MyQ must connect with the printer within this timeout.
`jobSenderSendTimeOutInMS`	8.2+	3600000 ms	Jobs must be sent to the printer within this time limit. IPP only.
`jobSenderServerBusyRetryInMS`	8.2+	5000 ms	If the printer returns a server-busy error, MyQ waits for the specified retry interval before attempting to resend the job. For example, the IPP protocol may return the server-busy error if too many jobs are queued.
`jobSenderServerErrorMaxRetryInMS`	8.2+	30000 ms	Maximal retry interval after error when sending a job. See `jobSenderServerErrorMinRetryInMS` for more details.
`jobSenderServerErrorMinRetryInMS`	8.2+	5000 ms	If an error occurs when sending a job, MyQ waits for the specified retry interval before attempting to resend the job. For each subsequent attempt, the waiting time doubles, up to the value of `jobSenderServerErrorMaxRetryInMS`.
`jobSenderShutdownTimeOutInMS`	8.2+	600000	When MyQ finishes sending data, it closes the connection and waits for the close event from the printer. This parameter sets, in milliseconds, the timeout of waiting for the event (0 = infinite). The default is equivalent to 10 minutes. On some printers or in some networks the event does not come, so use a lower timeout to ensure that the user session finishes.
`nonSessionScanTimeOut`	8.2+	5	If a scan is received and there is no user session on the printer, MyQ searches for a recent user session to learn the user. This parameter specifies how far into the past (in seconds) MyQ looks.
`printerUnreachableTimeout`	8.2+	60	If the printer is unreachable for longer than this parameter, interrupt the session. Jobs that have not been sent to the printer yet, will not be printed. The user can print them in their next session.
`readyJobsSortAsc`	8.2+	`false`	How to sort ready jobs in the My Jobs screen