🚀 TrueNAS – P15: FTP TrueNAS Configuration Tutorial (Step-by-Step Setup)

Setting up FTP TrueNAS correctly ensures secure and reliable file transfer inside your internal network or lab environment.

In this guide, you will learn how to configure FTP on TrueNAS step by step, create a dedicated FTP dataset, enable FTP services, and connect from Windows using WinSCP.

This tutorial is designed for:

• 🏢 Internal file transfer

• 💾 Backup operations

• 🖥️ Department file exchange

• 🧪 Home lab testing

• 🔐 Controlled local FTP access

Let’s configure it properly.

📌 Why Use FTP on TrueNAS?

Although SMB and NFS are popular, FTP still has practical use cases:

✅ Lightweight file transfer
✅ Simple user-based authentication
✅ Easy integration with Windows tools
✅ Suitable for internal backup workflows
✅ Fast deployment

When configured correctly, FTP TrueNAS works reliably in controlled environments.

🧩 1️⃣ Configuring Services on TrueNAS

We will complete three main steps on TrueNAS:

• Create a dataset for FTP

• Enable FTP service

• Create a local FTP user

🔧 Step 1 – Create a Dataset for FTP

Go to:

Storage → Datasets → Add Dataset

Create a dedicated dataset for FTP usage.

This is highly recommended instead of using an existing department dataset.
A separate dataset prevents permission conflicts and improves access control.

Example dataset name:

ftpbackup

Save the configuration.

🌐 Step 2 – Enable FTP Service

Go to:

Services → FTP

Enable the FTP service.

Then configure the following:

GUI → Advanced → Access

✔ Tick Allow Local User Login

This option is critical.
Without enabling local user login, your FTP account will not authenticate successfully.

Start the service and enable automatic startup if required.

👤 Step 3 – Create a Local FTP User

Go to:

Accounts → Users → Add

Create a local user:

Username example:

ftpbackup

Set:

• Home Directory → Select the FTP dataset

• Shell → nologin (recommended for security)

• Set a strong password

When the user is created, permissions for this FTP user will be automatically generated.

This ensures proper ownership of the dataset.

🖥️ 2️⃣ Configuration on Windows or Client Side

Once FTP TrueNAS is configured, you can test access from Windows.

💻 Install FTP Client Application

Example:

WinSCP

Download and install WinSCP (or any FTP client).

🔑 Connect to TrueNAS FTP

In WinSCP:

• File Protocol: FTP

• Hostname: TrueNAS IP address

• Port: 21 (default)

• Username: ftpbackup

• Password: (your configured password)

Click Login

If configuration is correct, you should see your FTP dataset directory.

⚠️ Real Case: Department Folder Permission Failure

During implementation, the FTP folder inside the Department dataset failed.

Reason:

The FTP user did not have access rights to the parent dataset Department.

Additionally, the server was experiencing Active Directory errors, which prevented adding ACLs for the FTP user to the Department dataset.

Because of this:

• ACL modifications failed

• FTP access was denied

• Permission inheritance did not work correctly

✅ Solution Applied

To resolve the issue:

I recreated the FTP dataset outside of volume 1, making it independent from the Department dataset.

This avoids:

• AD-related ACL conflicts

• Parent dataset permission inheritance issues

• Access control complications

The configuration process remains the same for child datasets, but using a dedicated FTP dataset ensures stability and easier troubleshooting.

🔐 FTP TrueNAS Security Best Practices

To secure your FTP setup:

✔ Use local users only
✔ Avoid exposing FTP to the public internet
✔ Use strong passwords
✔ Limit dataset access strictly
✔ Consider FTPS if encryption is required

FTP is suitable for internal environments.
For public access, secure alternatives are recommended.

⚡ Common FTP TrueNAS Troubleshooting

If login fails:

• Check Allow Local User Login

• Verify dataset ownership

• Confirm correct home directory

• Restart FTP service

• Check firewall rules

If permission errors appear:

• Validate dataset ACL

• Avoid mixing AD + local permissions

• Use separate dataset instead of parent inheritance

🎯 When Should You Use FTP TrueNAS?

FTP TrueNAS is ideal for:

• Internal backup automation

• Department file drop zones

• Lab testing environments

• Legacy system integration

• Controlled LAN-based transfers

For simple and controlled environments, FTP remains practical and easy to manage.

🏁 Conclusion

Configuring FTP TrueNAS is straightforward when done correctly:

1️⃣ Create a dedicated dataset
2️⃣ Enable FTP service with local login
3️⃣ Create a local FTP user
4️⃣ Connect using WinSCP
5️⃣ Avoid complex parent dataset permission inheritance

By isolating your FTP dataset, you reduce permission conflicts and simplify management.

This setup is lightweight, efficient, and ideal for lab or small business environments.

Mastering FTP TrueNAS configuration adds another essential skill to your TrueNAS administration toolkit.