TrueNAS Scale (Community Edition)

TrueNAS SCALE is a powerful, open-source network attached storage (NAS) operating system built on Linux and the ZFS file system. It provides enterprise-grade features for home labs, small businesses, and even large enterprises.

TrueNAS SCALE (formerly known as just "Scale") is designed to be user-friendly while offering advanced capabilities like:

• ZFS File System: Provides data integrity through checksums, snapshots, and self-healing properties
• Docker App Support: Run containers directly from the web interface with a built-in app store
• Virtualization: Create and manage virtual machines alongside your storage services
• Multi-Protocol Sharing: SMB (Windows), NFS (Linux/Unix), iSCSI (block storage)
• Data Protection: Built-in snapshots, replication, cloud sync, and backup capabilities

Before installation, ensure your hardware meets these minimum requirements:

• Ensure you have at least two hard drives available
• One drive will be used for the TrueNAS boot system
• Additional drives can be added later to your storage pool

Download the latest ISO from TrueNAS Downloads and create a bootable USB stick using tools like:

• Rufus (Windows)
• Etcher (Cross-platform)
• dd command on Linux/macOS

1. Boot your system from the USB drive
2. Select "Install/Upgrade" from the boot menu
3. Choose the target disk for installation (usually /dev/sda or similar)
4. Wait for the installation to complete (~5-10 minutes)
5. Remove the USB and reboot into TrueNAS SCALE

After reboot, access the web interface:

http://<your-truenas-ip-address>

Default credentials are typically root with no password (or a temporary one shown on console).

1. Navigate to Storage → Create Pool
2. Give your pool a descriptive name (e.g., "data-pool")
3. Select drives for the pool layout:
   • Mirror: Best performance and redundancy, 50% capacity efficiency
   • RAIDz1: Single drive fault tolerance, better space efficiency than mirror
   • RAIDz2/3: Double or triple drive fault tolerance (more advanced)
4. Click Create to initialize the pool

Datasets are where your data lives and can have unique permissions:

1. Go to Storage → Select your pool → Add Dataset
2. Name your dataset appropriately (e.g., "media", "documents")
3. Choose a preset based on usage:
   • Generic: Default UNIX permissions
   • SMB: For Windows file shares with ACLs
   • Apps: Optimized for Docker containers
   • Multiprotocol: Supports both SMB and NFS simultaneously
4. Click Save

1. Navigate to Shares → Windows Shares (SMB)
2. Click the + icon to add a new share
3. Select your dataset and configure:
   • Name for network access
   • Allow guest access if needed
   • Enable/disable caching options
4. Save and enable the SMB service under Services
5. Access from Windows: \\<truenas-ip>\sharename
6. Access from macOS/Linux via NFS or SMB protocol

1. Go to Shares → Block (iSCSI)
2. Create a new target with a descriptive name
3. Add an extent pointing to your dataset or zvol
4. Configure initiator settings for connecting clients
5. Use on Windows: Open "Disk Management" and discover iSCSI targets
6. On Linux, use iscsiadm commands to connect

Scrub tasks check data integrity across your pool:

1. Navigate to Data Protection → Scrub Tasks
2. Click + Add Task
3. Select frequency (weekly is recommended)
4. Set threshold days before running if needed
5. Save and monitor alerts for any issues found

Snapshots freeze data at a point in time:

1. Go to Data Protection → Periodic Snapshot Tasks
2. Click + Add Task
3. Select your dataset(s)
4. Configure schedule (daily snapshots recommended with 2-week retention minimum)
5. Set lifetime and compression settings
6. Save the task

1. Navigate to Data Protection → S.M.A.R.T. Tests
2. Add a new test schedule:
   • Weekly short tests (quick drive check)
   • Monthly or quarterly long tests (thorough analysis)
3. Configure email alerts for failures
4. Save and monitor results regularly

TrueNAS SCALE includes an integrated app store:

1. Go to Apps → App Catalog
2. Browse available applications like Plex, Nextcloud, Home Assistant
3. Click on any app to view details and installation options
4. Configure resources (CPU, RAM) as needed
5. Deploy with one click - apps run in isolated containers
6. Access via web interface or mapped ports

Symptoms: One drive marked as failed, pool still accessible but vulnerable
Likely Causes: Drive failure, loose cable, power issue
Fix Steps:

1. Check physical connections and replace cables if needed
2. Run S.M.A.R.T. test on the suspect drive
3. If confirmed dead: Storage → Select pool → Replace disk with new one
4. Wait for resilver to complete (can take hours/days depending on size)
5. Monitor progress in Dashboard alerts

Symptoms: File transfers slower than expected
Likely Causes: Suboptimal vdev layout, insufficient RAM, network bottleneck
Fix Steps:

1. Check pool configuration - mirrors generally outperform RAIDz for small setups
2. Ensure you have adequate RAM (ZFS uses available memory as cache)
3. Verify network speed with iperf or similar tools between client and NAS
4. Consider adding an SSD cache tier if using HDDs exclusively
5. Review active services that might be consuming resources

Symptoms: Container stuck in "starting" state, error messages
Likely Causes: Resource constraints, network conflicts, port collisions
Fix Steps:

1. Check System Settings → General for available RAM/CPU headroom
2. Review app-specific logs under the Apps dashboard
3. Verify no other service is using required ports (e.g., 80, 443)
4. Try reinstalling with different port mappings if needed
5. Ensure Docker daemon has sufficient disk space in /mnt/pool/docker

Symptoms: Network path error when trying to connect
Likely Causes: Service not running, firewall blocking, wrong credentials
Fix Steps:

1. Verify Services → SMB/CIFS is enabled and started
2. Check network profile on TrueNAS (LAN vs WAN settings)
3. Ensure Windows Firewall allows File & Printer Sharing
4. Confirm username/password matches a user created in TrueNAS
5. Try accessing via IP address instead of hostname: \\192.168.x.x\sharename

• ✅ Start Simple: Begin with one pool and mirror layout before exploring RAIDz configurations
• ✅ Name Everything Clearly: Use descriptive names for pools, datasets, shares, and users
• ✅ Enable Notifications: Set up email alerts in System Settings → General to catch issues early
• ✅ Regular Backups: Don't rely solely on snapshots - use cloud sync or replication tasks
• ✅ Monitor Health: Check Dashboard weekly for any warnings or degraded components
• ❌ Avoid Over-Provisioning: Start with default advanced settings until you understand their impact
• ❌ Don't Mix Drive Sizes: Using different capacity drives in the same vdev wastes space on smaller ones

Once your basic TrueNAS SCALE installation is working:

1. Explore virtualization by creating VMs for additional services
2. Set up replication tasks to a second NAS or cloud storage
3. Configure Active Directory integration for enterprise environments
4. Implement multi-factor authentication (MFA) for admin accounts
5. Review and optimize your network configuration with VLANs if needed
6. Consider upgrading hardware components as needs grow

TrueNAS SCALE offers tremendous flexibility once you understand its core concepts. Start small, learn incrementally, and leverage the active community forums when stuck.