Effortlessly Rename Your Truenas Scale Pool: Step-by-Step Guide
Ever found yourself needing to change the pool name in TrueNAS Scale, only to realize it's not as straightforward as it seems? Don't worry, you've come to the right place. In this comprehensive guide, we'll walk you through the process step by step, ensuring you understand each move and, most importantly, making sure your data stays secure.
Before we dive in, let's clarify what a pool is in the context of TrueNAS Scale. A pool is essentially a collection of disks used for data storage. It defines the layout of the data on the disks and sets the rules for how that data is protected. Now that we've established that, let's proceed with changing the pool name.
Understanding Pool Names
Pool names are case-sensitive and can contain alphanumeric characters. However, they cannot start with a number or contain any special characters. They're not just labels; they're used extensively in commands and scripts, so choosing a name that you can easily remember and use is crucial.



Now, why might you want to change a pool name? Perhaps you've just set up a new pool and realize you'd prefer a more descriptive or less generic name. Or maybe your storage needs have evolved, and old names no longer accurately reflect your current setup.
Preparing to Change the Pool Name
Before making any changes, it's essential to take a full backup of your system. This is not a step to be taken lightly; it's your safety net in case something goes awry. Once you've ensured your data's safety, you can proceed.



Then, log in to the TrueNAS Scale console. You'll need elevated privileges for this task, so if you're not already logged in as the admin user, switch to it using the command `su -`.
Renaming the Pool
To change the pool name, you'll use the `bhyvectl` command. Here's the syntax: `bhyvectl pool rename old_name new_name`. Replace `old_name` with your current pool name and `new_name` with the new one you've chosen.
For instance, if your current pool name is `data` and you want to rename it to `production`, you would run the command like this: `bhyvectl pool rename data production`.






Verifying the Pool Name Change
After running the command, your pool name should be updated throughout the system. You can verify this by checking the Systems > Pools page in the web interface. Ensure that the new name appears there.
If you're using scripts or commands that reference the pool name, you might need to update those as well to ensure they're still functioning correctly with the new name.
Updating Pool Names in Systems Tasks
Any tasks, such as snapshots or replication jobs, that were bound to the old pool name will still work, but you might want to update them to use the new name. To do this, edit the task in the web interface and update the pool selection.

This step is not strictly necessary, as the tasks will continue to run with the old name, but using the new name ensures that any new tasks or anyifth-party tools you introduce into your system will work seamlessly.
In conclusion, changing the pool name in TrueNAS Scale is a straightforward process once you understand the underlying concepts. Just remember to always backup your data before any significant changes and to verify the system's behavior after the change. Now that you know how, go ahead and organize your storage setup to your liking!





