System Properties Reference

This reference consolidates all Artifactory system properties related to Federated repositories. Properties are configured in the artifactory.system.properties file unless otherwise noted. For example, to change the metadata worker thread count:

artifactory.persistentQueue.trigger.number.of.threads=15

Queue and Event Properties

The following properties control queue and event behavior.

Property	Description	Default	Applies to
`artifactory.events.log.cleanup.age.of.entries.to.discard.days`	Amount of time events remain in the queue before purging	3 days	Both
`artifactory.persistentQueue.trigger.number.of.threads`	Number of metadata worker threads (restart required)	10	Both
`artifactory.persistentQueue.max.lock.lease.time.minutes`	Delay interval between attempts to trigger the queue	1 minute	Both
`artifactory.federated.event.queue.max.error.retries`	Number of attempts before queue becomes exhausted and eligible for auto-healing	6	Both

Bulk Mirroring Properties

The following properties control bulk mirroring behavior.

Property	Description	Default	Applies to
`artifactory.federated.mirror.events.bulk.exclude.repo.types`	Excludes specific package types from bulk event mirroring. Use `*` for all types, or comma-separated list (for example, `docker,composer,npm`)	(none)	Both
`artifactory.federated.mirror.events.bulk.max.pools`	Number of available event processing thread pools (executors)	4 (maximum: 5)	Both
`artifactory.federated.mirror.events.bulk.threadsPerPool`	Number of threads per pool (executor)	4 (maximum: 5)	Both
`artifactory.federated.mirror.events.batch.message.bulk.size`	Number of Event Queue events sent with each replication message	100	Both
`artifactory.federated.mirror.events.bulk.executor.poll.timeout.minutes`	Time new requests wait if all processing pools are occupied	2 minutes	Both
`artifactory.federated.bulk.properties.enabled`	Enable bulk property fetching from the database (introduced in 7.100.x)	false	Both

Full Sync Properties

The following properties control Full Sync behavior.

Property	Description	Default	Applies to
`artifactory.federated.mirror.events.bulk.fullSync.threadsPerPool`	Threads per pool for Full Sync (dedicated executor)	10	Both
`artifactory.federated.mirror.events.bulk.fullSync.executor.wait.timeout.minutes`	Wait time for Full Sync calls for other repositories while pool is busy	2 minutes	Both
`artifactory.full.sync.batch.retry.count`	Number of retries for a failing batch during Full Sync	5	Both
`artifactory.full.sync.batch.retry.quiet.period.seconds`	Wait time between batch retries (requires 7.77.3+)	5 seconds	Both
`artifactory.federated.full.sync.pooling.wait.time.sec`	Polling interval used to check whether the remote member's Full Sync file list is ready	30 seconds	Both
`artifactory.federated.full.sync.use.aql`	Use AQL query for Full Sync file list (`true`) or SQL queries (`false`)	true	Both
`artifactory.federated.full.sync.paging.threshold`	Artifact count threshold for using paging (when AQL is disabled)	400,000	Both
`artifactory.federated.full.sync.page.size`	Number of rows per database query when paging	100,000	Both
`artifactory.federated.full.sync.pages.per.file`	Number of pages per temporary file for sorting	4	Both
`artifactory.federated.repo.full.sync.enabled.inMemorySorter`	Enable in-memory sorting instead of database sorting	false	Both
`artifactory.federated.repo.full.sync.limit.entries.for.split`	Number of artifacts sorted at one time (when in-memory sorting is enabled)	400,000	Both

Auto-Healing Properties

The following properties control auto-healing behavior.

Property	Description	Default	Applies to
`artifactory.auto.healing.job.interval.sec`	Interval at which auto-healing checks for exhausted queues	20 seconds	Both
`artifactory.federated.subsequent.event.grace.period`	Buffer for federated negotiation	60 seconds	Both
`artifactory.reset.stale.full.sync.job.interval.min`	Interval for the async task that resets stuck Full Sync operations	15 minutes	Both
`artifactory.reset.stale.full.sync.job.initial.delay.min`	Initial delay before running the stuck Full Sync reset task	1 minute	Both
`artifactory.federation.health.check.job.sec`	How often Artifactory runs the federation health-check job that auto-reconnects a broken RTFS gRPC client and re-registers the federation queue. Doesn't enable RTFS on lagging HA nodes after a partial migration.	80 seconds	Both

Metadata Synchronization Properties

The following property controls metadata synchronization behavior.

Property	Description	Default	Applies to
`artifactory.federated.mirror.events.upload.info.propagate.enabled`	Enable synchronization of uploadedBy, lastFileModified, deploymentDate metadata (introduced in 7.90.1)	false	Both

Metrics Properties

The following properties control metrics behavior.

Property	Description	Default	Applies to
`artifactory.federated.metrics.enabled`	Enable metrics writing for Federated repositories	false	Legacy
`artifactory.federated.metrics.sync.threshold.time.ms`	Minimum threshold above which the Open Metrics counter indicates a repo has breached the sync threshold	20,000 ms	Legacy
`artifactory.federated.metrics.monitoring.interval.time.sec`	Measurement interval for Federation synchronization	30 seconds	Legacy
`artifactory.federated.metrics.exclude.disabled`	Exclude disabled mirrors from metrics writing	true	Legacy
`artifactory.federated.metrics.enable.count.disabled.members`	Count disabled members across all Federations	true	Legacy

Network and Timeout Properties

The following property controls network and timeout behavior.

Property	Description	Default	Applies to
`artifactory.mirror.http.client.socket.timeout.mili`	Socket timeout when syncing large repositories between Federation members (available from 7.38.17)	(system default)	Both

Oracle RAC Properties

The following property applies to Oracle RAC instances.

Property	Description	Default	Applies to
`artifactory.oracle.node.events.sequence.is.no.cache`	Enable converter that fixes Oracle node events sequence definition for RAC instances (requires 7.71.16+ or 7.77.8+)	false	Legacy

Migration Properties

The following properties control migration from legacy Federation to RTFS.

Property	Description	Default	Applies to
`rtfs.auto.migration.enabled`	Enable automatic migration from legacy Federation to RTFS. When enabled, the system automatically migrates eligible repositories.	false	RTFS
`rtfs.auto.migration.job.minutes`	Interval in minutes at which the auto-migration job runs to check for and migrate eligible repositories.	(see FAQ)	RTFS

Tenant Move Properties

The following property controls tenant move behavior.

Property	Description	Default	Applies to
`rtfs.tenant.move.export.lag.offset.grace.period.min`	Grace period in minutes before export finalization. Captures in-flight events to minimize data loss during tenant migration between regions.	10	RTFS

Binary Store Configuration

The following property is configured in binarystore.xml under the Federated provider section, not in artifactory.system.properties.

Property	Description	Default
`numberOfRemoteImporters`	Number of binary import workers	6