HOWTO: Copy the hidden ix-apps dataset from one pool to another

Hi!
I’m trying to move my apps from my main pool to a new “apps” pool with SSDs.
I just can’t get the whole thing to run if I just do the steps above. I have all the app locations set manually like for nextcloud: "Pool/nextcloud/config or /app or so on…

How can I get this done?

Thank you so much for this “Howto”. :heart:
Still works perfectly for the current TrueNAS Scale v. 25.04.2.1!

Literally saved me my bütt when (due to external circumstances) having to move my TrueNAS-Installation to a VM with the drives passed through to the VM. But when I set it all up and made all other backups, I had forgotten about moving the “ix-apps” directory, because I thought it wasn’t as relevant, since any persistent data from configured containers is stored in a different pool anyway. However, the TrueNAS-Configs to actually run these containers is still stored in the “ix-apps”.

In my case I had to set up the relevant pool completely new due to hardware limitations not allowing me to use the same zfs-pool configuration as in the original TrueNas baremetal installation. So I am thankful for this, really. Allowing me to move / migrate these apps step by step away from TrueNAS (since TrueNAS now is a VM) to my new main hypervisor’s level, but keep them running until I am ready to make the switch for each individually.

Also surely TrueNAS itself saved my bütt too, allowing to really smoothly reimporting the old configs. Even the affected pool it was mounting perfectly, even in a degraded state. It was enough to correct the stuff I forgot to fix before.

1 Like

I wish however, this was made easier using the UI by TrueNAS itself. Reading older forum posts, there once had been a solution to migrate all settings to the pool I designate to be the “newpool” automatically.

After hours in despair, unable to figure out what to do, I stumbled on your post.
I take my hat off and bow!

Thanks,

Rudi

1 Like

bloody brilliant! Thank you so much! This worked brilliantly.

1 Like

Followed your suggestion and for some reason the Make Destination Dataset Read-only? option didn’t persist when I launched the task. Replication passed but using the pool failed because truenas_catalog was read-only. Restarted and edited the task to find that this option was not properly set. I had to make sure this was set to IGNORE and all is working:

Thx! Helped a lot! :pray:

Thanks for the awesome guide. I needed to move my .ix-apps due to some very large docker images filling up the existing pool.

Something confuse me. Once replication is completed you have old dataset as well as new one mounted at the same point ./ix-app. I think this is dramatically wrong and dangerous.

Furthermore I was not able to delete original ix-app dateset, it reported as in use.

So this procedure duplicate the space on two dataset and is unknown were data came from/to as Mas both are mounted ad same folder.

Despite, I wonder why goldeye release indrotuced auto replication, that apart another replication bug that need to be fixed, reproduce your procedure and result : old dataset is neither deledable neither unmountable

When you unset the apps pool, TrueNAS unmounts the apps dataset.

When it activates an apps pool, it mounts it.

1 Like

Mmm you are saying that if I set the new data pool, this will not unset automatically the old one? Quite strange as set commans visually acts as a mutual exclusion (drop down menu) no a multiple choice. And if I switch back and forward the pools, only a single set of apps is showed, not both. I mean, mounting both show just one. It seems a bug…. But I will give a try asap

Oook right suggestion.

Steps to disable the default mountpoint of the old ix-apps dataset follows

  1. once the replication is completed, go to apps→configuration→unset pool
  2. open shell zfs list | grep ix-apps show you the default mountpoints both for your new and old dataset
  3. to disable old dataset default mountpoint run this fordsin$(zfs list -H -o name olddataset/ix-apps);do zfs set mountpoint=none "$ds"done
  4. check again with zfs list | grep ix-apps
  5. reboot Truenas
  6. go to apps→configuration→set pool→your new pool

Hello everyone, I started something and ended up breaking everything. Nothing will start anymore, I really need help, I’m desperate.

From what I understand, it’s coming from the mounting points, but I can’t seem to fix the problem.

Can you help me?I have so much stuff in there :s

I have a useless mount point that reappears every time I start the engine

ix application and my old pool (and now mounted in /mnt/mnt… I can’t even go back)

root@truenas[/]# zfs list | grep ix-apps
Ix-appllication-ssd/ix-apps                                                                                          57.6G  81.9G   292K  /mnt/.ix-apps
Ix-appllication-ssd/ix-apps/app_configs                                                                              67.2M  81.9G  65.0M  /mnt/.ix-apps/app_configs
Ix-appllication-ssd/ix-apps/app_mounts                                                                               36.4G  81.9G   128K  /mnt/.ix-apps/app_mounts
Ix-appllication-ssd/ix-apps/app_mounts/code-server                                                                    760K  81.9G   112K  /mnt/.ix-apps/app_mounts/code-server
Ix-appllication-ssd/ix-apps/app_mounts/code-server/config                                                             104K  81.9G   104K  /mnt/.ix-apps/app_mounts/code-server/config
Ix-appllication-ssd/ix-apps/app_mounts/code-server/local                                                              448K  81.9G   116K  /mnt/.ix-apps/app_mounts/code-server/local
Ix-appllication-ssd/ix-apps/app_mounts/code-server/project                                                             96K  81.9G    96K  /mnt/.ix-apps/app_mounts/code-server/project
Ix-appllication-ssd/ix-apps/app_mounts/deluge                                                                        80.5M  81.9G    96K  /mnt/.ix-apps/app_mounts/deluge
Ix-appllication-ssd/ix-apps/app_mounts/deluge/config                                                                 80.4M  81.9G  31.7M  /mnt/.ix-apps/app_mounts/deluge/config
Ix-appllication-ssd/ix-apps/app_mounts/frigate                                                                       9.48G  81.9G   104K  /mnt/.ix-apps/app_mounts/frigate
Ix-appllication-ssd/ix-apps/app_mounts/frigate/cache                                                                  165M  81.9G  9.71M  /mnt/.ix-apps/app_mounts/frigate/cache
Ix-appllication-ssd/ix-apps/app_mounts/frigate/media                                                                 9.32G  81.9G  6.23G  /mnt/.ix-apps/app_mounts/frigate/media
Ix-appllication-ssd/ix-apps/app_mounts/nextcloud                                                                      889M  81.9G   128K  /mnt/.ix-apps/app_mounts/nextcloud
Ix-appllication-ssd/ix-apps/app_mounts/nextcloud-1                                                                    387M  81.9G   104K  /mnt/.ix-apps/app_mounts/nextcloud-1
Ix-appllication-ssd/ix-apps/app_mounts/nextcloud-1/html                                                               374M  81.9G   374M  /mnt/.ix-apps/app_mounts/nextcloud-1/html
Ix-appllication-ssd/ix-apps/app_mounts/nextcloud-1/postgres_data                                                     13.5M  81.9G  13.5M  /mnt/.ix-apps/app_mounts/nextcloud-1/postgres_data
Ix-appllication-ssd/ix-apps/app_mounts/nextcloud-test                                                                11.7G  81.9G    96K  /mnt/.ix-apps/app_mounts/nextcloud-test
Ix-appllication-ssd/ix-apps/app_mounts/nextcloud-test/html                                                           7.40G  81.9G   548M  /mnt/.ix-apps/app_mounts/nextcloud-test/html
Ix-appllication-ssd/ix-apps/app_mounts/nextcloud-test/postgres_data                                                  4.35G  81.9G   248M  /mnt/.ix-apps/app_mounts/nextcloud-test/postgres_data
Ix-appllication-ssd/ix-apps/app_mounts/nextcloud/data                                                                  96K  81.9G    96K  /mnt/.ix-apps/app_mounts/nextcloud/data
Ix-appllication-ssd/ix-apps/app_mounts/nextcloud/html                                                                  96K  81.9G    96K  /mnt/.ix-apps/app_mounts/nextcloud/html
Ix-appllication-ssd/ix-apps/app_mounts/nextcloud/ix-postgres_backups                                                  889M  81.9G   889M  /mnt/.ix-apps/app_mounts/nextcloud/ix-postgres_backups
Ix-appllication-ssd/ix-apps/app_mounts/nextcloud/pgData                                                                96K  81.9G    96K  /mnt/.ix-apps/app_mounts/nextcloud/pgData
Ix-appllication-ssd/ix-apps/app_mounts/nextcloud1                                                                    11.4M  81.9G   112K  /mnt/.ix-apps/app_mounts/nextcloud1
Ix-appllication-ssd/ix-apps/app_mounts/nextcloud1/data                                                                 96K  81.9G    96K  /mnt/.ix-apps/app_mounts/nextcloud1/data
Ix-appllication-ssd/ix-apps/app_mounts/nextcloud1/pgBackup                                                             96K  81.9G    96K  /mnt/.ix-apps/app_mounts/nextcloud1/pgBackup
Ix-appllication-ssd/ix-apps/app_mounts/nextcloud1/pgData                                                             11.1M  81.9G  10.8M  /mnt/.ix-apps/app_mounts/nextcloud1/pgData
Ix-appllication-ssd/ix-apps/app_mounts/ollama                                                                        3.10G  81.9G    96K  /mnt/.ix-apps/app_mounts/ollama
Ix-appllication-ssd/ix-apps/app_mounts/ollama/data                                                                   3.10G  81.9G  3.10G  /mnt/.ix-apps/app_mounts/ollama/data
Ix-appllication-ssd/ix-apps/app_mounts/open-webui                                                                    1.59G  81.9G   104K  /mnt/.ix-apps/app_mounts/open-webui
Ix-appllication-ssd/ix-apps/app_mounts/open-webui/data                                                               1.59G  81.9G  1.59G  /mnt/.ix-apps/app_mounts/open-webui/data
Ix-appllication-ssd/ix-apps/app_mounts/open-webui/ollama                                                             1.35M  81.9G   100K  /mnt/.ix-apps/app_mounts/open-webui/ollama
Ix-appllication-ssd/ix-apps/app_mounts/plex                                                                          9.08G  81.9G   104K  /mnt/.ix-apps/app_mounts/plex
Ix-appllication-ssd/ix-apps/app_mounts/plex/config                                                                   9.08G  81.9G  4.62G  /mnt/.ix-apps/app_mounts/plex/config
Ix-appllication-ssd/ix-apps/app_mounts/plex/data                                                                       96K  81.9G    96K  /mnt/.ix-apps/app_mounts/plex/data
Ix-appllication-ssd/ix-apps/app_mounts/portainer                                                                     4.95M  81.9G    96K  /mnt/.ix-apps/app_mounts/portainer
Ix-appllication-ssd/ix-apps/app_mounts/portainer/data                                                                4.86M  81.9G   764K  /mnt/.ix-apps/app_mounts/portainer/data
Ix-appllication-ssd/ix-apps/app_mounts/speedtest-tracker                                                             5.27M  81.9G    96K  /mnt/.ix-apps/app_mounts/speedtest-tracker
Ix-appllication-ssd/ix-apps/app_mounts/speedtest-tracker/config                                                      5.17M  81.9G  1.04M  /mnt/.ix-apps/app_mounts/speedtest-tracker/config
Ix-appllication-ssd/ix-apps/docker                                                                                   20.8G  81.9G  19.0G  /mnt/.ix-apps/docker
Ix-appllication-ssd/ix-apps/truenas_catalog                                                                           393M  81.9G   286M  /mnt/.ix-apps/truenas_catalog
Zpool-NVME/ix-apps                                                                                                   41.4G   187G  8.09M  /mnt/.ix-apps
Zpool-NVME/ix-apps/app_configs                                                                                         96K   187G    96K  /mnt/.ix-apps/app_configs
Zpool-NVME/ix-apps/app_mounts                                                                                          96K   187G    96K  /mnt/.ix-apps/app_mounts
Zpool-NVME/ix-apps/catalogs                                                                                           234M   187G  56.5M  /mnt/.ix-apps/catalogs
Zpool-NVME/ix-apps/default_volumes                                                                                     96K   187G    96K  /mnt/.ix-apps/default_volumes
Zpool-NVME/ix-apps/default_volumes-ix-applications-backup-system-update--2024-09-23_05:42:18-clone                     96K   187G    96K  /mnt/.ix-apps/default_volumes-ix-applications-backup-system-update--2024-09-23_05:42:18-clone
Zpool-NVME/ix-apps/docker                                                                                             164K   187G   164K  /mnt/.ix-apps/docker
Zpool-NVME/ix-apps/k3s                                                                                               38.0G   187G  18.1G  /mnt/.ix-apps/k3s
Zpool-NVME/ix-apps/k3s/kubelet                                                                                       1.45M   187G   608K  /mnt/.ix-apps/k3s/kubelet
Zpool-NVME/ix-apps/releases                                                                                          2.95G   187G   144K  /mnt/.ix-apps/releases
Zpool-NVME/ix-apps/releases/deluge                                                                                   14.9M   187G   112K  /mnt/.ix-apps/releases/deluge
Zpool-NVME/ix-apps/releases/deluge/charts                                                                            1.44M   187G  1.44M  /mnt/.ix-apps/releases/deluge/charts
Zpool-NVME/ix-apps/releases/deluge/volumes                                                                           13.3M   187G   104K  /mnt/.ix-apps/releases/deluge/volumes
Zpool-NVME/ix-apps/releases/deluge/volumes/ix_volumes                                                                13.1M   187G   112K  /mnt/.ix-apps/releases/deluge/volumes/ix_volumes
Zpool-NVME/ix-apps/releases/deluge/volumes/ix_volumes/config                                                         12.8M   187G  12.8M  /mnt/.ix-apps/releases/deluge/volumes/ix_volumes/config
Zpool-NVME/ix-apps/releases/deluge/volumes/ix_volumes/downloads                                                        96K   187G    96K  /mnt/.ix-apps/releases/deluge/volumes/ix_volumes/downloads
Zpool-NVME/ix-apps/releases/frigate                                                                                   856K   187G   112K  /mnt/.ix-apps/releases/frigate
Zpool-NVME/ix-apps/releases/frigate/charts                                                                            400K   187G   400K  /mnt/.ix-apps/releases/frigate/charts
Zpool-NVME/ix-apps/releases/frigate/volumes                                                                           272K   187G   104K  /mnt/.ix-apps/releases/frigate/volumes
Zpool-NVME/ix-apps/releases/frigate/volumes/ix_volumes                                                                104K   187G   104K  /mnt/.ix-apps/releases/frigate/volumes/ix_volumes
Zpool-NVME/ix-apps/releases/nextcloud                                                                                1.00G   187G   112K  /mnt/.ix-apps/releases/nextcloud
Zpool-NVME/ix-apps/releases/nextcloud/charts                                                                         4.98M   187G  4.90M  /mnt/.ix-apps/releases/nextcloud/charts
Zpool-NVME/ix-apps/releases/nextcloud/volumes                                                                        1023M   187G   104K  /mnt/.ix-apps/releases/nextcloud/volumes
Zpool-NVME/ix-apps/releases/nextcloud/volumes/ix_volumes                                                             1023M   187G   136K  /mnt/.ix-apps/releases/nextcloud/volumes/ix_volumes
Zpool-NVME/ix-apps/releases/nextcloud/volumes/ix_volumes/data                                                          96K   187G    96K  /mnt/.ix-apps/releases/nextcloud/volumes/ix_volumes/data
Zpool-NVME/ix-apps/releases/nextcloud/volumes/ix_volumes/html                                                          96K   187G    96K  /mnt/.ix-apps/releases/nextcloud/volumes/ix_volumes/html
Zpool-NVME/ix-apps/releases/nextcloud/volumes/ix_volumes/ix-postgres_backups                                         1022M   187G  1022M  /mnt/.ix-apps/releases/nextcloud/volumes/ix_volumes/ix-postgres_backups
Zpool-NVME/ix-apps/releases/nextcloud/volumes/ix_volumes/pgData                                                        96K   187G    96K  /mnt/.ix-apps/releases/nextcloud/volumes/ix_volumes/pgData
Zpool-NVME/ix-apps/releases/nextcloud1                                                                               11.9M   187G   112K  /mnt/.ix-apps/releases/nextcloud1
Zpool-NVME/ix-apps/releases/nextcloud1/charts                                                                         304K   187G   304K  /mnt/.ix-apps/releases/nextcloud1/charts
Zpool-NVME/ix-apps/releases/nextcloud1/volumes                                                                       11.4M   187G   104K  /mnt/.ix-apps/releases/nextcloud1/volumes
Zpool-NVME/ix-apps/releases/nextcloud1/volumes/ix_volumes                                                            11.3M   187G   120K  /mnt/.ix-apps/releases/nextcloud1/volumes/ix_volumes
Zpool-NVME/ix-apps/releases/nextcloud1/volumes/ix_volumes/data                                                         96K   187G    96K  /mnt/.ix-apps/releases/nextcloud1/volumes/ix_volumes/data
Zpool-NVME/ix-apps/releases/nextcloud1/volumes/ix_volumes/pgBackup                                                     96K   187G    96K  /mnt/.ix-apps/releases/nextcloud1/volumes/ix_volumes/pgBackup
Zpool-NVME/ix-apps/releases/nextcloud1/volumes/ix_volumes/pgData                                                     10.9M   187G  10.9M  /mnt/.ix-apps/releases/nextcloud1/volumes/ix_volumes/pgData
Zpool-NVME/ix-apps/releases/plex-utills                                                                              1.92G   187G   112K  /mnt/.ix-apps/releases/plex-utills
Zpool-NVME/ix-apps/releases/plex-utills/charts                                                                       4.47M   187G  4.47M  /mnt/.ix-apps/releases/plex-utills/charts
Zpool-NVME/ix-apps/releases/plex-utills/volumes                                                                      1.92G   187G   128K  /mnt/.ix-apps/releases/plex-utills/volumes
Zpool-NVME/ix-apps/releases/plex-utills/volumes/ix_volumes                                                             96K   187G    96K  /mnt/.ix-apps/releases/plex-utills/volumes/ix_volumes
Zpool-NVME/ix-apps/releases/plex-utills/volumes/pvc-7bb48c6f-7fdb-428d-a7ac-b8d3efa20a56                               96K   187G    96K  /mnt/.ix-apps/releases/plex-utills/volumes/pvc-7bb48c6f-7fdb-428d-a7ac-b8d3efa20a56
Zpool-NVME/ix-apps/releases/plex-utills/volumes/pvc-82708e38-6262-480d-a24b-32e53294b479                              324K   187G   248K  /mnt/.ix-apps/releases/plex-utills/volumes/pvc-82708e38-6262-480d-a24b-32e53294b479
Zpool-NVME/ix-apps/releases/plex-utills/volumes/pvc-9625e3bc-1383-41aa-a418-78070578ca0b                             1.92G   187G  1.92G  /mnt/.ix-apps/releases/plex-utills/volumes/pvc-9625e3bc-1383-41aa-a418-78070578ca0b
Zpool-NVME/ix-apps/truenas_catalog                                                                                    233M   187G   233M  /mnt/.ix-apps/truenas_catalog
root@truenas[/]# cd /mnt/mnt/Ix-appllication-ssd 
root@truenas[/mnt/mnt/Ix-appllication-ssd]# pwd
/mnt/mnt/Ix-appllication-ssd
root@truenas[/mnt/mnt/Ix-appllication-ssd]# cd /mnt
root@truenas[/mnt]# ls
Zpool-NVME  Zpool-SAS-6TO  mnt
root@truenas[/mnt]# 

Okay, I managed to restore my apps, but I’m still on my old app pool. I’m so afraid of starting over and messing everything up again.

Are you on 25.04.X or 25.10.0? 25.10 introduced a gui buildin way to migrate your apps.

2 Likes

Unfortunately, I can’t upgrade to 25.10.0 because my graphics card is no longer compatible :s

Can we expect an official addition in TrueNAS 25.04? Or perhaps the development of a small script? Thank you.

Since the migration tool was introduced in 25.10 I doubt it will get backported to 25.04

Thanks a lot for the guide, made me through it.

However I would add one very important step. (As I learned the hard way)

After step 1, you should run a snapshoot task. As apperntly “Replication Task” uses snapshot to replicate.

I ended up losing 4 days worth of changes in immich due do this. ( 4 day old snapshot )

1 Like