# nodl One SSD upgrade
Applies to:
nodl One with encryption ("unlock" password) or nodl One Mk.2 (1TB)
# Why Upgrade
If your SSD ran out of space due to the increasing size of the blockchain and indexes, you need to upgrade to a bigger drive. You may also need to upgrade or replace the SSD if it's running out of spare blocks (end of lifetime).
# Before you start
Required tools:
- 2mm hex (T10 Torx works too) key or driver
- Phillips head screwdriver
- Sharp knife or fishing line (to carefully separate the hard drive from the board)
- USB 3.0 to SATA cable (we recommend the Sabrent brand, though others may work)
Required parts:
- 2.5" SATA SSD (2TB or 4TB) - our preference is the Samsung EVO 870 range
- Strip of double sided tape (optional)
# Step 1 - Shutdown your device
Shut down your NODL One only after it is unlocked and connected. Use the red button in the UI to do so. Wait a few minutes until the device doesn't show network and disk activity.
WARNING
DO NOT UNPLUG THE DEVICE WITHOUT SHUTTING IT DOWN PROPERLY.
# Step 2 - Connect the new drive
Connect your replacement drive to the NODL using the USB 3.0 to SATA cable.
You can plug the cable into:
- The blue USB port (located above the L-shaped board). Faster (~1.5 hours) but with a higher risk of crashing
- One of the black USB ports. Slower (~9 hrs 15 min) but more stable
If correctly installed, blue light should be lit on the cable.
# Step 3 - Power on the nodl
Plug in and power up the NODL.
WARNING
DO NOT UNLOCK THE DEVICE
If you're using a Mac, open the Terminal app. On a recent Windows, open cmd.exe or PowerShell. On Linux, open any terminal of your choosing.
# Step 4 - Clone the drive to the new one
Run the following commands from your terminal.
ssh rock@NODL—NAME.local -p 22222
or
ssh rock@192.168.xx.yy -p 22222
Replace NODL-NAME with the actual two words name of your nodl or the IP address with the actual IP address.
When prompted, enter the SSH password (provided in the letter included with your device).
Gain permanent root access running:
sudo su -
Then check that the new drive is visible:
ls /dev/sd*
You should see:
/dev/sda /dev/sda1 /dev/sda2 /dev/sda3 /dev/sdb
WARNING
If you don't see /dev/sdb
turn off the device by runnung halt -p
, wait a few minutes, unplug the power, plug the external drive into another USB port and restart from Step 3.
WARNING
You may see /dev/sda /dev/sdb /dev/sdb1 /dev/sdb2 /dev/sdb3 instead. If it's the case, don't continue the process and contact support immediately. If you continue YOU WILL ERASE ALL YOUR EXISTING DATA.
Start a screen session. This will allow you to reconnect to the device if your SSH connection gets lost or if you turn off your computer:
screen
You will see a splash screen, simply press the Enter/Return key to continue.
The pv command will allow you to see progress, to check if it's installed and install it if it's not, run the following (we also install cloud-guest-utils which will be required later):
apt update ; apt -y install pv cloud-guest-utils
We can now begin the clone process:
dd if=/dev/sda bs=1M | pv | dd of=/dev/sdb bs=1M
If SSH disconnects or if you need to leave with your computer, you can SSH back into the device:
ssh rock@NODL—NAME.local -p 22222
or
ssh rock@192.168.xx.yy -p 22222
Then run
sudo su -
and
screen -dr
You will re-attach to your previous session and see what happened while you were disconnected.
At the end of the copy, you should see something similar to:
1000204886016 bytes (1.0 TB, 932 GiB) copied, 30246.6 s, 33.1 MB/s
root@NODL-NAME:~#
You can now safely shutdown the device by running:
halt -p
Wait a few minutes and unplug the power, then the drive.
# Step 5 - Hard drive replacement procedure
# Step 5a - Remove the philips screws
Unscrew the four Phillips head screws located under the outer casing of the NODL One.
# Step 5b - Remove the hex screws
Using the hex or torx key or driver, remove the four remaining screws securing the internal structure.
# Step 5c - Disconnect the L-shaped nodl bridge board
Carefully detach the L-shaped bridge board from the USB ports.
# Step 5d - Store Small Parts Safely
Place the bridge board and all removed screws in a small plastic bag or container to avoid misplacing them.
# Step 5e - Remove the Outer Casings
Gently separate the top and bottom parts of the outer case.
WARNING
Be careful not to damage or put pressure on the ports during this step.
# Step 5f – Remove and Replace the Hard Drive
- Use a sharp knife or fishing line to carefully separate cut the glue/ double sided tape on the drive from the mounting board.
- Disconnect the SATA data and power connectors from the old drive.
- Plug in your new cloned drive.
- Press it gently into place, making sure the connectors are properly aligned.
# Step 5g - Reassemble the NODL One
- Reattach the lower outer casing with the Phillips screws.
- Reattach the lower outer casing with the Hex or Torx screws
- Reconnect the L-shaped USB bridge board by firmly pressing it into place.
# Step 6 - Expand to use the new available space
Power on the device and wait a few minutes, then SSH back into the device:
ssh rock@NODL—NAME.local -p 22222
or
ssh rock@192.168.xx.yy -p 22222
Become root:
sudo su -
Increase the size of the sda3 partition (yes, there is a space between sda and 3 in this command):
growpart /dev/sda 3
Increase the size of the md1 array:
mdadm --grow /dev/md1 -z max —assume-clean
Go to the nodl UI and unlock device by entering the "unlock" password:
Once unlocked, increase the size of the encrypted partition:
cryptsetup resize opt
resize2fs /dev/mapper/opt
After a few minutes, you should see the now increased available space in the UI.
Finnaly, remove the empty settings.json file that was created when the disk became full:
rm /mnt/opt/bitcoin/.bitcoin/settings.json
Enjoy your "new" nodl!
Many thanks for our user for contributing this guide.