debianzfs/README.md
Kris Lamoureux 2b07753419
Add CLI options for mirroring
Includes slight refactor into functions
2022-11-27 03:35:55 -05:00

51 lines
1.7 KiB
Markdown

# DebianZFS
DebianZFS is a bash script that automates a UEFI Debian installation on an encrypted ZFS pool. The script installs `zfsutils-linux` on Debian Live, then proceeds to partition, create the boot and root zpools, and [debootstraps](https://wiki.debian.org/Debootstrap) a minimal system.
Due to [licensing concerns with OpenZFS and Linux](https://openzfs.github.io/openzfs-docs/License.html), distributing the resulting binaries together in a disk image may be a copyright violation. However, nothing keeps you from legally building and keeping your own disk images.
- Requires packer and qemu to build images
### Quick Start
1. Clone the repository and navigate into the directory
```
git clone https://git.krislamo.org/kris/debianzfs
cd debianzfs
```
2. Build image
```
make
```
3. Copy qcow2 image to libvirt/images
```
sudo cp output/debianzfs.qcow2 /var/lib/libvirt/images/
```
4. Make a Libvirt VM and start
```
sudo virt-install --name debianzfs \
--description 'Debian ZFS' \
--ram 2048 \
--vcpus 2 \
--disk /var/lib/libvirt/images/debianzfs.qcow2 \
--os-type generic \
--network bridge=virbr0 \
--graphics vnc,listen=127.0.0.1,port=5901 \
--boot uefi,loader=/usr/shar/OVMF/OVMF_CODE.fd
```
5. If dropped into UEFI shell
```
Shell> FS0:
FS0:\> EFI\debian\grubx64.efi
```
6. If dropped into initramfs
```
zpool import -f rpool
exit
```
7. Enter rpool password: `letmeinzfs!`
8. Login with root's password: `changeme`
### License
- DebianZFS is licensed under 0BSD, a public domain equivalent license; see the `LICENSE` file for more information