TrueNAS pool recovery

A degraded TrueNAS pool must be handled by vdev topology, not by treating each disk independently.

TrueNAS uses ZFS pools built from vdevs. The effect of a failed disk depends on whether that disk belongs to a mirror, RAIDZ group, special vdev, log, cache, or another role.

Understand the symptom

Pool status reflects whether each top-level vdev can still provide required data.

WHY

What is happening

Redundancy is defined within vdevs, not across arbitrary disks in the pool. A special metadata vdev can be critical even when most data disks are healthy. Resilvering and scrubbing read broadly and write new state; they are maintenance operations, not source-preservation steps for a pool with multiple weak members or an uncertain failure sequence.

What you may see

Symptoms that change the recovery path.

01

Pool shows DEGRADED

The pool remains accessible but one or more devices have errors, are missing, or are being replaced.

02

Pool is OFFLINE or unavailable

A required top-level vdev or too many members may be missing for normal import.

03

Resilver stalls or errors increase

Another member may be weak, causing the rebuild workload to expose additional unreadable regions.

04

Encryption unlock fails

Dataset keys, SED credentials, pool import, and filesystem availability are separate layers.

Protect the source

Actions that can make the situation worse.

01

Wrong-disk replacement changes state

Replacing or detaching a current member can remove the last valid copy of required data.

02

Force import can replay transactions

Import options may change the pool state or discard recent transaction groups.

03

Scrub stresses every member

Broad reads can accelerate a disk that is already returning errors.

Do this now

Safe steps before evaluation.

01

Capture zpool status and events

Save pool GUIDs, vdev tree, device IDs, error counts, scan status, and recent alerts.

02

Photograph and label all bays

Preserve slot order plus removed, spare, replacement, special, cache, and log devices.

03

Secure keys and configuration

Keep dataset keys, passphrases, SED credentials, TrueNAS config exports, and host details.

04

Stop a harmful resilver

If errors are increasing or a second member is unstable, preserve the devices before continuing broad reads.

NEPFOSYS process

How a data-first evaluation proceeds.

01

Topology and history review

NEPFOSYS maps vdev roles, redundancy, pool GUIDs, replacements, and the exact failure sequence.

02

Member-level acquisition

Unstable devices are imaged individually with unreadable regions recorded.

03

Virtual pool reconstruction

ZFS metadata, transaction groups, datasets, encryption state, and priority files are evaluated from protected sources.

A clear next step

Preserve the original device before another repair or recovery attempt.

Start a case with the exact symptoms, incident timeline, prior attempts, encryption details, and the files that matter most. NEPFOSYS will route the case to the appropriate DFW intake or nationwide mail-in path.

Start with a case review

Questions, answered

What customers ask before starting.

Should I immediately replace a failed TrueNAS disk?

Only when the remaining vdev members are healthy and the topology is certain. Multiple errors or weak members call for preservation first.

Can a cache or log device cause total pool loss?

The role and state matter. Cache is normally noncritical, while special vdevs can contain essential metadata and some log configurations require careful handling.

Do you need the TrueNAS configuration backup?

It can help identify pools, shares, encryption settings, networking, and prior device assignments, so preserve it with the disks.

DFW local · Nationwide mail-in

Protect the device. Start with the facts.

Start my recovery case