truenas scale change pool name

Effortlessly Rename Your Truenas Scale Pool: Step-by-Step Guide

By Christopher Smith
AD

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.

AD
an image of a swimming pool with instructions
an image of a swimming pool with instructions
the different shapes and sizes of water
the different shapes and sizes of water
the instructions for swimming shoes are shown in blue and white, with numbers on each side
the instructions for swimming shoes are shown in blue and white, with numbers on each side

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.

the table has four different numbers on it and is labeled in blue, white, and gray
the table has four different numbers on it and is labeled in blue, white, and gray
an in ground swimming pool is shown with measurements for the size and width of it
an in ground swimming pool is shown with measurements for the size and width of it
Tallímetro Menorca Edition
Tallímetro Menorca Edition

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.

AD

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`.

Types Of Pool Shapes, Pool Design Blueprint, Swimming Pool Layout, Swimming Pool Shapes & Sizes, Pool Design Ideas Layout, Swimming Pool Designs Plan, Outdoor Inground Swimming Pools, Layout Swimming Pool Plan, Pool Plans Layout
Types Of Pool Shapes, Pool Design Blueprint, Swimming Pool Layout, Swimming Pool Shapes & Sizes, Pool Design Ideas Layout, Swimming Pool Designs Plan, Outdoor Inground Swimming Pools, Layout Swimming Pool Plan, Pool Plans Layout
Trendy Pool Team Names for 2026
Trendy Pool Team Names for 2026
an iphone screen showing the different shades of water and how they are used to describe it
an iphone screen showing the different shades of water and how they are used to describe it
an empty swimming pool is shown with measurements
an empty swimming pool is shown with measurements
an info sheet showing the different types of boats in the water, and how they are used
an info sheet showing the different types of boats in the water, and how they are used
the different shades of blue are shown on this page, and it is also available for use
the different shades of blue are shown on this page, and it is also available for use

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.

AD

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.

truenas scale change pool name
truenas scale change pool name

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!

AD
AD