From a64f71f6a67081d9d2be41a581c66e5b44c89ca2 Mon Sep 17 00:00:00 2001
From: Nicolas MASSE <nicolas.masse@itix.fr>
Date: Thu, 30 Oct 2025 11:17:25 +0100
Subject: [PATCH] doc

---
 README.md | 73 +++++++++++++++++++++++++++++++++++++++++++++++++++++++
 1 file changed, 73 insertions(+)
 create mode 100644 README.md

diff --git a/README.md b/README.md
new file mode 100644
index 0000000..b0b3d7c
--- /dev/null
+++ b/README.md
@@ -0,0 +1,73 @@
+# ZFS RPM packages for aarch64 architecture for Fedora, CentOS Stream & RHEL
+
+## Purpose
+
+This repository provides ZFS and libvirt RPM packages compiled specifically for the aarch64 (ARM64) architecture on Fedora, CentOS Stream, and RHEL systems. The main goals are:
+
+- **ZFS Support on ARM64**: Provides native ZFS filesystem support for aarch64 systems where official ZFS packages may not be available or up-to-date
+- **Libvirt with ZFS Storage**: Patches libvirt to enable ZFS storage pool support on aarch64 architecture, allowing virtualization environments to leverage ZFS storage backends
+- **Multi-distribution Support**: Builds packages for multiple Linux distributions (Fedora 41-43, CentOS Stream 9-10) to ensure broad compatibility
+- **Automated Building**: Uses COPR (Cool Other Package Repo) infrastructure for automated building and distribution
+
+The repository automatically downloads upstream source RPMs, applies necessary patches (especially the `20-enable-zfs.patch` for libvirt), and builds optimized packages for ARM64 systems.
+
+## Usage
+
+### Installing ZFS Packages
+
+The packages are built and hosted on COPR. To use them on your aarch64 system:
+
+1. **Enable the COPR repository:**
+   ```bash
+   sudo dnf copr enable nmasse-itix/zfs-aarch64
+   ```
+
+2. **Install ZFS packages:**
+   ```bash
+   # Install ZFS userspace utilities
+   sudo dnf install zfs zfs-dkms
+   
+   # Install libvirt with ZFS support
+   sudo dnf install libvirt
+   ```
+
+And then follow the [Getting Started](https://openzfs.github.io/openzfs-docs/Getting%20Started/index.html) documentation.
+
+### Supported Distributions
+
+- **Fedora**: 41, 42, 43
+- **CentOS Stream**: 9, 10
+- **RHEL**: 9, 10 (via EPEL repositories)
+
+### Using ZFS with Libvirt
+
+After installing the patched libvirt package, you can create ZFS storage pools:
+
+```bash
+# Create a ZFS storage pool definition
+virsh pool-define-as mypool zfs - - - - /path/to/zfs/dataset
+
+# Start and enable the pool
+virsh pool-start mypool
+virsh pool-autostart mypool
+```
+
+## Development
+
+If you want to fork this repo and build it yourself, here are the instructions with `copr-cli`.
+
+```sh
+copr-cli create --chroot fedora-41-aarch64 --chroot fedora-42-aarch64 --chroot epel-9-aarch64 --chroot epel-10-aarch64 zfs-aarch64
+```
+
+And then send the build to COPR.
+
+```sh
+./build.sh
+```
+
+## License
+
+The source code of ZFS, Libvirt and the Fedora RPM spec files remain licensed under their original license.
+The patches and top-level scripts may be too trivial to receive a license.
+In case a license is required for them, they are under MIT License.