Expand storage with an NVMe M.2 SSD 15 min

If you have installed a secondary internal NVMe SSD in your Olares One, you can merge it into the main system storage using the olares-cli.

Unlike external drives which are mounted as separate folders, this method uses Logical Volume Management (LVM) to seamlessly extend your root file system.

Before you begin

One-time irreversible operation

This is a one-time operation. The SSD becomes an integral part of the system volume and cannot be easily separated later.
If you physically uninstall this SSD after extension, the Olares file system will be incomplete, causing the OS to crash or fail to boot. You will need to manually reinstall Olares OS.

The Olares One motherboard includes two PCIe SSD slots:

Slot 1 (PCIe 4.0): Occupied by the preinstalled 2TB system SSD.
Slot 2 (PCIe 5.0): Available for expansion.

You can use this second slot to expand your current system storage.

Prerequisites

Hardware

Your Olares One is set up and running.
A secondary NVMe M.2 SSD is physically installed in Olares One.

SSH access

SSH access to Olares One.

Experience

Basic familiarity with terminal commands and the command-line interface (CLI).

Step 1: Identify the unmounted disk

Connect to your Olares One terminal via SSH or from the Control Hub.
List block devices on the host:
bash
```
lsblk | grep -v loop
```

Check the size and mount points to identify the new disk.

Example output:

text

NAME        MAJ:MIN RM   SIZE RO TYPE MOUNTPOINTS
sda           8:0    0 931.5G  0 disk
├─sda1        8:1    0   512M  0 part /boot
└─sda2        8:2    0   931G  0 part /
nvme1n1     259:3    0 931.5G  0 disk

In this example, sda is the system drive which is mounted at / and /boot, while nvme1n1 is the new, unmounted SSD.

Step 2: Extend system storage

Verify that Olares recognizes the unmounted disk:
bash
```
olares-cli disk list-unmounted
```
Run the extension command:
bash
```
olares-cli disk extend
```

When the command prompts for confirmation, type YES to proceed.

bash

WARNING: This will DESTROY all data on /dev/<device>
Type 'YES' to continue, CTRL+C to abort:

Example output:

bash

Selected volume group to extend: olares-vg
Selected logical volume to extend: data
Selected unmounted device to use: /dev/nvme0n1
Extending logical volume data in volume group olares-vg using device /dev/nvme0n1
WARNING: This will DESTROY all data on /dev/nvme0n1
Type 'YES' to continue, CTRL+C to abort: YES
Selected device /dev/nvme0n1 has existing partitions. Cleaning up...
Deleting existing partitions on device /dev/nvme0n1...
Creating partition on device /dev/nvme0n1...
Creating physical volume on device /dev/nvme0n1...
Extending volume group olares-vg with logic volume data on device /dev/nvme0n1...
Disk extension completed successfully.

id  LV    VG         LSize    Mountpoints
1   data  olares-vg  <3.63t   /var,/olares
2   root  olares-vg  100.00g  /
3   swap  olares-vg  1.00g
...

Step 3: Verify the extension

You can verify the storage increase from Control Hub (UI), or via the command line.

Expand storage with an NVMe M.2 SSD 15 min ​

Before you begin ​

Prerequisites ​

Step 1: Identify the unmounted disk ​

Step 2: Extend system storage ​

Step 3: Verify the extension ​

Resources ​