# Best way to clone/migrate UmbrelOS

**URL:** <https://community.umbrel.com/t/best-way-to-clone-migrate-umbrelos/22883>\
**Category:** Guides\
**Created:** [June 3, 2025, 9:41am UTC](https://community.umbrel.com/t/best-way-to-clone-migrate-umbrelos/22883 "2025-06-03T09:41:28Z")\
**Posts on this page:** 1\
**Page:** 1

<div class="post-metadata">

**Author:** ![goyban](https://avatars.discourse-cdn.com/v4/letter/g/5f9b8f/32.png) [@goyban](https://community.umbrel.com/u/goyban)\
**Post date:** [June 3, 2025, 9:41am UTC](https://community.umbrel.com/t/best-way-to-clone-migrate-umbrelos/22883/1 "2025-06-03T09:41:28Z")

</div>

**You need to change the storage you are using, how to do that in a way so you don’t loose your data, lightning channels, blockchain and Umbrel doesn’t yell at you?**

_You want to upgrade from a 1TB SSD to a 2TB nvme?_  
_You want to move from a failing SSD to a brand new one?_  
_Your new SSD is slightly smaller than the original one, making it impossible/hard to clone using clonezilla or other softwares?_  
This guide will work for all of them!

* * *

**Notice!** You are going to need a live linux image in order to make it work just make sure does contain `GParted` that will make your life way easier.

- First we need to understand how UmbrelOS storage works after UmbrelOSv1.0:  
A typical Umbrel installation on x86\_64 arch, will create 4 partitions:

 ![Figure1: Example of UmbrelOS partition scheme](https://canada1.discourse-cdn.com/flex030/uploads/getumbrel/original/2X/4/4ef192478105f7dcc5cb278f8803b6a2e0d042be.jpeg)

**Important** : Those two OS partitions are used for OTA updates, and they will mostly replaced each time you update your UmbrelOS, they are DESIGNED to be separated from data partition.  
So:  
We only need to take car of data partition!

* * *

**Let’s break down the steps:**

1. Take out your old storage, insert the new one and install UmbrelOS on your new disk/SSD/nvme. This will create all the needed partitions on your new disk. You can go ahead, create an account and login to it to make sure it works (don’t install any application).
2. Connect your old and new disk to a computer and boot any live Linux image.
3. Open the terminal and run `lsblk` to make sure you have two disks, then use `gparted` (or any other software) to see which disk contains data on 4th (data) partition (In Figure1, you can easily see that /dev/nvme0n1p4 is half full, showing that is the source disk), **spend as much time as needed here to be 100% sure which one is your `source` and which one is your `destination` disk!!**  
 ![Figure2: Example output of lsblk, please note that you should see two of these disks!](https://canada1.discourse-cdn.com/flex030/uploads/getumbrel/original/2X/e/e8d0dfd896e6bb2dde81d76ad6211ec7a330366c.jpeg)

> Let’s say our source is `/dev/sda4` and our destination is `/dev/nvme0n1p4`

1. Mount source and destination partitions:

```auto
    sudo mkdir /mnt/source
    sudo mkdir /mnt/destination
    sudo mount /dev/sda4 /mnt/source
    sudo mount /dev/nvme0n1p4 /mnt/source

```

1. Verify your source and destination again, yes, AGAIN!  
`ls /mnt/source/umbrel-os/home/umbrel/umbrel/app-data/`  
You should see all your installed applications here (Figure3).  
 ![Figure3: Verifying the source disk](https://canada1.discourse-cdn.com/flex030/uploads/getumbrel/optimized/2X/1/14608ca4d130c5bbc430152461f2122b52c563d3_2_690x45.jpeg)  
Do the same thing for your destination.
2. Now we are going to `rsync` with `-aAXv` to carefully clone data partition files with all their permissions and attributes:

* * *

7.1. We are not in a hurry so why not check what is going to happen? So first we use `--dry-run` to make sure everything is fine:

```auto
sudo rsync -aAXv --delete --info=progress2 --dry-run /mnt/source/ /mnt/destination/

```

7.2. If everything is fine we do the next step, running the actual command:

> **ATTENTION!** This will delete everything on /mnt/destination/ !  
> **Important!** Do not forget to put the “/” at the end of each folder! /mnt/source or /mnt/destination can lead to problems!

```auto
sudo rsync -aAXv --delete --info=progress2 /mnt/source/ /mnt/destination/

```

It will take some time (Specially if you have the entire blockchain) so let it do its thing.  
7.3. Now, you guessed it! We verify it again, using checksum for a final integrity check!

```auto
sudo rsync -aAXv --delete --checksum --info=progress2 --log-file=/tmp/rsync-errors.log /mnt/source/ /mnt/destination/

```

> **Important!** Check for any error when the final check finishes, you can also check the log file created at `/tmp/rsync-erros.log`

7.4. Unmount the partitions:

```auto
    sudo umount /dev/sda4 /mnt/source
    sudo umount /dev/nvme0n1p4 /mnt/source

```

7.5. Turn off the computer.

* * *

1. Now only put the new disk/ssd/nvme on your computer and turn it on, Voila! Everything should be there! Congratulations!  
Enjoy \<3