FreeCORE - The Complete Guide

Deploying, Administering, and Mastering the Open-Source NAS Platform Born from TrueNAS CORE

Introduction

1. What This Book Covers
2. How to Use This Book
3. Prerequisites
4. Version Notes

Chapter 1: The Story of FreeCORE, From TrueNAS CORE to Open-Source Continuation

1. The TrueNAS Legacy: How an Open-Source NAS Became Industry Standard
2. The Fork That Changed Everything: iXsystems Ends Free TrueNAS CORE Support
3. Enter FreeCORE: Community, Philosophy, and Project Goals
4. What’s the Same, What’s Different: Comparing FreeCORE to TrueNAS CORE
5. Choosing Your Path: FreeCORE vs. TrueNAS SCALE vs. Alternatives

Chapter 2: Architecture Deep Dive, Understanding How FreeCORE Works

1. FreeBSD at the Core: Why This Matters for Stability and Performance
2. OpenZFS Integration: The Storage Engine That Makes It All Work
3. The Middleware Layer: How Services Talk to the Operating System
4. The Web UI and CLI: Two Interfaces, One System
5. Boot Environments and Updates: Atomic Upgrades Explained

Chapter 3: Planning Your Deployment, Requirements, Topologies, and Design Decisions

1. Hardware Requirements: Minimum, Recommended, and Production-Class
2. CPU, Memory, and Motherboard: What Matters for ZFS Performance
3. Storage Planning: Disk Selection, Controllers, and Topology Choices
4. Network Design: Speed, Redundancy, and Protocol Considerations
5. Deployment Scenarios: Home Lab, Small Business, Enterprise Edge

Chapter 4: Installation, Getting FreeCORE Running on Your Hardware

1. Preparing Your Installation Media: USB Creation and Verification
2. The Installer Walkthrough: Every Screen Explained
3. Advanced Installation Options: Disk Selection and Boot Configuration
4. Verifying the Installation: Health Checks and First Boot Procedures
5. Troubleshooting Installation Problems: Common Failure Modes

Chapter 5: Initial Configuration, From Fresh Install to Functional NAS

1. Network Configuration: IP Addressing, DNS, and Gateway Setup
2. System Settings: Hostname, Time Synchronization, and Console Access
3. Creating Your First Storage Pool: Step-by-Step with Verification
4. Initial User and Group Setup: Local Accounts and Privileges
5. Enabling Essential Services: SSH, NTP, and Logging

Chapter 6: ZFS Fundamentals, Understanding the Filesystem That Powers Everything

1. Why ZFS: Copy-on-Write, Checksumming, and Self-Healing Explained
2. Pool Architecture: How vdevs, Mirrors, and RAID-Z Work Together
3. Datasets and Volume Types: Organizing Your Storage Logically
4. RAID Configurations Compared: Mirror vs. RAIDZ1 vs. RAIDZ2 vs. RAIDZ3
5. The ZFS Intent Log and Write Cache: Performance and Safety Trade-offs

Chapter 7: Storage Administration, Managing Pools, Datasets, and Disks

1. Creating and Expanding Pools: Procedures and Best Practices
2. Dataset Management: Properties, Quotas, and Reservations
3. Disk Replacement Procedures: From Failure Detection to Rebuild Completion
4. Scrubs: Scheduling, Running, and Interpreting Results
5. SMART Monitoring and Predictive Failure Analysis

Chapter 8: Snapshots, Replication, and Data Protection

1. Snapshot Fundamentals: Creating, Managing, and Restoring Point-in-Time Copies
2. Automated Snapshot Policies: Schedules, Retention, and Naming Conventions
3. Replication Basics: Push vs. Pull, Deduplication, and Bandwidth Limits
4. Building a Backup Strategy with Snapshots and Replication
5. Disaster Recovery Scenarios: What to Do When Things Go Wrong

Chapter 9: Networking, Interfaces, VLANs, Routing, and Firewalling

1. Network Interface Configuration: Single NIC, LAGG, and Bonding Modes
2. VLAN Configuration: Tagging, Trunking, and Isolated Services
3. Advanced Networking: Bridges, Routing, and Multi-Homed Setups
4. DNS and DHCP: Integration with Existing Infrastructure
5. Firewall Rules: Protecting Your NAS from Unauthorized Access

Chapter 10: File Sharing Services, SMB, NFS, iSCSI, and More

1. SMB/CIFS Configuration: Shares, Permissions, and Windows Integration
2. NFS Exporting: Versions, Security Models, and Unix Clients
3. iSCSI Targets: Block Storage for Virtual Machines and Servers
4. FTP and SFTP: Legacy File Transfer with Modern Security
5. WebDAV and Other Protocols: Specialized Use Cases

Chapter 11: Users, Groups, Permissions, and Access Control

1. Local User and Group Management: Creating Accounts and Assigning Roles
2. Active Directory Integration: Joining the Domain and Mapping Users
3. LDAP and Other Directory Services: Alternative Authentication Backends
4. Filesystem Permissions: Unix Modes, SMB ACLs, and POSIX Compliance
5. NFSv4 ACLs: Unified Access Control for Mixed Environments

Chapter 12: Security Hardening, Monitoring, and Maintenance

1. Security Baseline: Disabling Unused Services and Closing Attack Vectors
2. SSL/TLS Certificates: Self-Signed vs. CA-Signed for Web UI and Services
3. Authentication Hardening: SSH Keys, Two-Factor Auth, and Password Policies
4. Logging and Monitoring: System Logs, Alerts, and Integration with External Tools
5. Routine Maintenance: Updates, Scrubs, Health Checks, and Documentation

Chapter 13: Advanced Topics, Automation, Migration, Performance Tuning, and Troubleshooting

1. Migrating from TrueNAS CORE to FreeCORE: Strategies and Data Preservation
2. Command-Line Administration: Essential zfs, zpool, and FreeCORE Commands
3. Automation with Scripts and APIs: Configuring via CLI and REST API
4. Performance Tuning: ARC, L2ARC, SLOG, and Kernel Parameters
5. Systematic Troubleshooting: Diagnostics, Logs, and Recovery Procedures

Conclusion: Operating FreeCORE in Production, Lessons and Recommendations

References