---
title: 'Install Alpine Linux on a QNAP TS-870U'
url: 'https://willifix.net/blog/install-alpine-linux-on-a-qnap-ts-870u'
markdown: 'https://willifix.net/blog/install-alpine-linux-on-a-qnap-ts-870u.md'
date: '2026-11-04'
description: 'Today I received a discarded QNAP device. Unfortunately, I’m not a big fan of QNAP’s software, so I took the time to take a closer look at it. Since the device itself doesn’t have any video ports, I’ll have to find another way to update the firmware if necessary. Assessment At first glance, the dev…'
---

# Install Alpine Linux on a QNAP TS-870U

## [Install Alpine Linux on a QNAP TS-870U](https://willifix.net/blog/install-alpine-linux-on-a-qnap-ts-870u)

    4th Nov 2026  

Today I received a discarded QNAP device. Unfortunately, I’m not a big fan of QNAP’s software, so I took the time to take a closer look at it. Since the device itself doesn’t have any video ports, I’ll have to find another way to update the firmware if necessary.

### Assessment

At first glance, the device didn’t give me much hope, since I only spotted a memory chip I hadn’t seen before.

![qnapdom.jpg](https://willifix.net/images/c/0/f/e/a/c0fea6e85d179ec5df7cb07a59dec121cd72b848-qnapdom.jpg)

After taking a closer look at the memory chip, I realized that the connector strongly resembled an internal USB header. With a little research, I found out that this is what’s known as a DOM. And indeed, it can be controlled via USB and behaves almost like a USB flash drive.

With a few DIY supplies (a USB-to-breakout cable), I was able to read the data from the flash drive on my PC.

![usbbreatkout.jpg](https://willifix.net/images/c/f/f/5/c/cff5cd6a802b20670ec61fca2474433de3891139-usbbreatkout.jpg)

Here's a picture of the pinout and how the DOM is recognized by the kernel:

Pin Layout
|  |  |  |
|---|---|---|
| Yellow USB +5V   Orange USB D-  Red USB D+  Brown USB GND | ![pinlayout.jpg](https://willifix.net/images/a/9/d/5/0/a9d50a3d4d6dd0d456d68a26dab6d048c1f31470-pinlayout.jpg) |

![RWill_2026-11-03 21-56-30.png](https://willifix.net/user/pages/03.blog/install-alpine-linux-on-a-qnap-ts-870u/RWill_2026-11-03%2021-56-30.png)

#### Dump the DOM

Since I wasn't sure if my experiment would work, the very first thing I did was create a backup of the DOM:

```
mkdir ./qnap_re
dd if=/dev/sda of=/path/to/backup/qnap-dom-backup.img bs=4M status=progress
```

After I created the image, I wanted to take a look at the DOMS structure. So I created a “loop” device and placed the image I'd just created inside it.

##### Inspect the DUMP

```
sudo losetup -Pf --show qnap-dom-backup.img
/dev/loop0
sudo -E gparted /dev/loop0
```

![RWill_2026-11-03 21-50-37.png](https://willifix.net/user/pages/03.blog/install-alpine-linux-on-a-qnap-ts-870u/RWill_2026-11-03%2021-50-37.png)As you can see, it's all pretty straightforward. After mounting each partition once, I understood the structure of the DOMS:

- Partition 1: GRUB bootloader files and modules. This is where the boot process begins.
- Partition 2: Primary boot partition containing: 
    - bzImage - Linux kernel
    - initrd.boot - Initial ramdisk
    - rootfs2.bz & rootfs\_ext.tgz - Compressed root filesystem
    - qpkg.tar - QNAP package system
    - All files have a .cksum for integrity verification
- Partition 3 Duplicate/backup of Part 2 (dual-boot or fallback firmware)
- Partition 5 Empty, likely reserved for config or logs
- Partition 6 Configuration storage: 
    - smb.conf - Samba configuration
    - uLinux.conf - System configuration
    - system.map.key - Possibly encryption or license keys

The way I see it, I should be able to modify the DOM so that a lightweight version of Linux (Alpine) starts up.

#### Prepare VM for alpine Setup

1. Firs download a a ISO (X86\_64) from [https://www.alpinelinux.org/downloads/](https://www.alpinelinux.org/downloads)
2. create a virtual Machine with that ISO
3. redirect the usb device to the vm and DO NOT use LUN because it makes me troubles (writeerrors)
4. boot the vm

Once Alpine has booted, we can begin configuring the DOM.

1. start fdisk (**fdisk /dev/sda**)
2. delete all existing partitions and persist the table
3. reboot (partprobe,blockdev does not work for me)
4. start setup-alpine
5. Follow the steps until you reach the “Disk & Install” step, then cancel.
6. install the needed extprogs (**apk add e2fsprogs**)
7. part the DOM (sda1 100MB boot | sda2 rootfs)
8. reboot (why does partprobe not work?)

![partcreate.png](https://willifix.net/user/pages/03.blog/install-alpine-linux-on-a-qnap-ts-870u/partcreate.png)

9. create the filesystems

    ```
    mkfs.vfat -F 32 /dev/sda1
    mkfs.ext4 /dev/sda2
    reboot
    ```
10. start setup-alpine and follow the steps until you reach the "Disk & Install" step, then cancel.
11. mount the existing partitions

    ```
    mount /dev/sda2 /mnt
    mkdir /mnt/boot
    mount /dev/sda1 /mnt/boot
    setup-disk -m sys /mnt
    ```
12. wait until the setup-disk tool is done

Now the system is on the DOM, but it still needs a bootloader. I'm using Syslinux here because it's lightweight and does the job.

```
apk add syslinux
dd bs=440 count=1 conv=notrunc if=/usr/share/syslinux/mbr.bin of=/dev/sda  
cp -a /usr/share/syslinux/menu.c32 /usr/share/syslinux/ldlinux.c32 /usr/share/syslinux/libcom32.c32 /usr/share/syslinux/libutil.c32 /mnt/boot/
extlinux --install /mnt/boot
fdisk /dev/sda 
 # press a 1 w that marks part1 as bootable
```

output of the commands:

![bootsetup.png](https://willifix.net/user/pages/03.blog/install-alpine-linux-on-a-qnap-ts-870u/bootsetup.png)

#### First boot from DOM

Now we're ready to remove the CD from the VM to see if the DOM boots Alpine. It looks good for me:

![alpineboot.png](https://willifix.net/user/pages/03.blog/install-alpine-linux-on-a-qnap-ts-870u/alpineboot.png)

i have inserted the DOM back in the QNAP and YES! one of the interfaces makes a DHCP offer. Afterwards i can sign in via SSH and have a running Alpine Linux Shell. The Disks getting recognized and i have successfully created a zpool.

 [ Previous Post](https://willifix.net/blog/truenas-automatic-netbox-inventory-items)

---

## Navigation

- Parent: [Blog](https://willifix.net/blog.md)
- Next: [TrueNAS Automatic Netbox Inventory Items](https://willifix.net/blog/truenas-automatic-netbox-inventory-items.md)