# How to set up persistent storage on systemrescue
The instructions on the official documentation are, in my oppinion, incomplete, 
so here you'll find how to correctly set up persistent storage

## Partitioning
Persistent storage requires an ext4, xfs or btrfs partition to write to, but
the normal installation method does not provide this automatically, manual input
is required

You must first use fdisk or any other disk partition tool to shrink the vfat
partition to make space for the ext4/xfs/btrfs partition

Here's how to do it with fdisk:
- run `fdisk /dev/sdX` where X is the disk where systemrescue is installed at
- delete the main partition with `d`
- create a new partition with `n`, make it primary with `p`, number 1 with `1`,
  leave the starting sector as-is and give it at least `+2G` end sector, make
  sure you don't remove the vfat signature when offered
- change the partition type to "W95 vfat (LBA)" with `t` and then `0c`
- make this shrinked partition bootable with `a`
- create another new partition with `n`, make it primary with `p`, number 2 
  with `2` and leave the start and end sectors as offered to make it take up 
  the rest of the drive
- write these changes with `w`

## Setting up the filesystem
run `mkfs.ext4 /dev/sdX2` where X is the drive number where systemrescue is
installed at or the equivalent for xfs or btrfs if you're using those

## Setting/changing the label name
You must give this persistent storage a label that you will later reference
in a systemmrescue YAML configuration file, you can do it with tune2fs or
similar tools

With tune2fs:
- run `tune2fs -L "YOURLABEL" /dev/sdX2` where X is the drive number where
  systemrescue is installed at

## YAML file changes
You must add the following in the global scope of a .yaml file in
systemrescue.d/:

```
global:
    cow_label=YOURLABEL
```