Olares

English

简体中文

English

简体中文

Appearance

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

Experience

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

Step 1: Identify the unmounted disk ​

  1. Connect to your Olares One terminal via SSH or from the Control Hub.

  2. List block devices on the host:

    bash
    lsblk | grep -v loop

  3. 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 ​

  1. Verify that Olares recognizes the unmounted disk:

    bash
    olares-cli disk list-unmounted

  2. Run the extension command:

    bash
    olares-cli disk extend

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

Resources ​