# Installing on the Yoga C630

## Before you start

Leave Windows in place. Lenovo ships firmware updates only through Windows, and
the per-model Qualcomm blobs Linux needs live in that partition — wiping it
means losing accelerated graphics, audio and the sensor hub permanently.
Update everything through Lenovo Vantage first.

Disable Secure Boot. The image is not signed for it:

- Press **Fn+F2** during startup, go to **Security → Secure Boot → Disabled**, or
- **Settings → Update & Security → Recovery → Advanced startup → UEFI Firmware Settings**

## Write the image

```sh
zstd -d fedora-44-minimal-lenovo-yoga-c630-*.img.zst
sudo dd if=fedora-44-minimal-lenovo-yoga-c630-*.img of=/dev/sdX bs=4M status=progress oflag=direct conv=fsync
```

Check `/dev/sdX` twice. An 8 GiB stick is enough for `minimal`, 16 GiB for
`workstation`; the root filesystem expands to fill whatever you use.

## First boot

Insert the stick and power on holding **Fn+F12** for the boot menu, or enter
setup with **Fn+F2** and put USB ahead of the internal drive.

GRUB should appear with one entry. It has already been told which device tree to
load — the C630's UEFI does not supply one, which is the whole reason the
`devicetree` line exists in the boot loader entry.

First boot does two slow things: it relabels the filesystem for SELinux and
grows the root partition. Several minutes on a USB stick is normal. Log in as
`fedora` / `fedora` and set a new password when prompted.

## Extract the Qualcomm firmware

Accelerated graphics, audio, the sensor hub and video decode do not work
until you do this:

```sh
sudo c630-firmware
sudo reboot
```

See [firmware.md](firmware.md) if it cannot find the Windows partition.

## Installing to internal storage

Once the USB image is behaving, copy it onto the internal UFS. Boot from the
USB stick and run, on the laptop:

```sh
sudo ./build/install-to-disk.sh --dry-run    # show the plan, touch nothing
sudo ./build/install-to-disk.sh              # do it
```

It partitions the disk, copies the running system across, and rewrites every
UUID that has to change. Reboot afterwards and pick the internal drive from the
boot menu (**Fn+F12**), or just pull the stick out.

**This wipes the target disk.** If you still have Windows and want to keep it,
do not run this — shrink the Windows partition from within Windows first and
adapt the steps by hand.

Two things about this machine make the obvious approaches fail, both of which
the script handles:

**You cannot `dd` the image onto the internal drive.** The UFS reports
**4096-byte logical sectors**; the disk image is built with 512-byte sector
geometry. Its GPT header and every partition offset would land in the wrong
place. The disk has to be partitioned on the machine, at its own sector size.

**`efibootmgr` does not work here.** There are no EFI runtime variables —
`efibootmgr` reports *"EFI variables are not supported on this system"* — so
nothing can register a boot entry. GRUB therefore goes at the removable-media
path, `EFI/BOOT/BOOTAA64.EFI`, where the firmware finds it unprompted.

If you would rather do it by hand, the sequence is: `sgdisk` an ESP, a `/boot`
and a root partition; `mkfs.vfat` and `mkfs.ext4 -O
^orphan_file,^metadata_csum_seed`; copy `/`, `/boot` and the ESP separately
(preserving xattrs, or SELinux labels are lost); then update `/etc/fstab`,
`/etc/kernel/cmdline`, `root=UUID=` in `/boot/loader/entries/*.conf`, and the
`--fs-uuid` in both `/boot/grub2/grub.cfg` and `EFI/fedora/grub.cfg`.

## If it does not boot

The kernel command line is the first thing to change. It lives in
`options` in `/boot/loader/entries/c630-*.conf`, and GRUB lets you edit it for
one boot by pressing **e**.

| Symptom | Try |
|---|---|
| Hangs immediately after GRUB, no kernel output | Wrong or missing device tree — check the `devicetree` line points at a file that exists in `/boot/dtb-*/qcom/` |
| Boots then freezes partway | Drop `efi=noruntime`, or add `pd_ignore_unused` if it is missing |
| USB dies during boot | Add `modprobe.blacklist=qcom_q6v5_pas` |
| Cannot find root filesystem | The initramfs is missing the UFS drivers — see `overlay/etc/dracut.conf.d/10-c630.conf` |
| 90-second stall early in boot | Add `systemd.tpm2_wait=0` |

Adding `earlycon` and `ignore_loglevel` will tell you a great deal more about
which of these it is.