Usenet¶

Configure NNTP providers, cascade vs pooled routing, and queue-side NNTP pipelining.

Headless ENV

Each config key below maps to NZBDAV_CONFIG__... via the naming algorithm (for example usenet.providers → NZBDAV_CONFIG__USENET__PROVIDERS).

Providers¶

Add one or more accounts. Each provider supports:

Control	What it does	Default / notes
Nickname	Friendly label instead of hostname	optional
Storage group	Same label → skip siblings after a clean article miss	optional; only same upstream
Host / Port	NNTP endpoint	port often `563`
Username / Password	Credentials	prefer SSL
Max Connections	Concurrent NNTP connections for this account	≤ plan limit
Pipeline depth	Per-provider override when pipelining on	blank = global `8`
Type	Disabled / Pool Connections / Backup Only	Pool
Use SSL	TLS for NNTP	on
Skip TLS certificate verification	Accept an invalid provider certificate	off
Data Cap	Block-account limit; auto-pauses near ~95%	uncapped
Already Used	Seed usage when migrating mid-block	empty
Auto-tune	Speed test → recommend connections + pipelining	action

Persisted as usenet.providers JSON.

Cleartext

Disabling SSL stores/sends credentials in cleartext on the wire — only for trusted networks.

Invalid provider certificates since 0.9.0 ¶

Leave Skip TLS certificate verification disabled unless a trusted provider has a certificate it cannot correct. It keeps the NNTP connection encrypted but accepts an untrusted, expired, or hostname-mismatched certificate. This permits a man-in-the-middle attacker to impersonate the provider and read credentials.

Routing and pipelining¶

Control	Config key	Default	Effect
Enable cascade routing	`usenet.cascade.enabled`	off	Prefer providers in drag order; off = shared pool. Thinly-spared primaries (≤25% free) yield to idler peers; larger MaxConnections alone does not outrank priority.
Re-probe primary after miss	`usenet.cascade.retry-primary-on-miss`	on	After a clean 430/451 on the first batch attempt, try the primary once more before cascading (multi-node spool). Off = skip straight to backups.
Enable NNTP pipelining	`usenet.pipelining.enabled`	off	Batch first-segment BODY during queue imports/benchmarks
Default pipeline depth	`usenet.pipelining.depth`	`8`	Requests in flight per connection (1–64)

Run Auto-tune before enabling queue pipelining. WebDAV streaming pipelining is a separate toggle on WebDAV.

See NNTP pipelining and Multi-provider.

Article-miss negative cache since 0.9.0 ¶

After a provider (or storage group) reports a definitive article miss (NNTP 430 or provider 451), InfiniDysk remembers that miss so later streaming/batch reads skip re-probing the same provider for the same article until the TTL expires. Transient failures (timeouts, network, corrupt articles) are never cached.

Control	Config key	Default	Effect
Miss-cache TTL (seconds)	`usenet.article-miss-cache-ttl-seconds`	`300`	How long a miss stays cached (clamped 30–86400)
Miss-cache max entries	`usenet.article-miss-cache-max-entries`	`10000`	Cap before oldest entries are evicted (clamped 100–1000000)

The cache clears automatically when Usenet providers are reconfigured.