1 files changed, 62 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 000000000000..f1df0732de6d
--- /dev/null
+++ b/README.md
@@ -0,0 +1,62 @@
+# postfix-policyd-spf-perl
+
+![AUR version](https://img.shields.io/aur/version/postfix-policyd-spf-perl?label=AUR)
+[![Build Status](https://drone.cryptic.systems/api/badges/volker.raschek/postfix-policyd-spf-perl-pkg/status.svg)](https://drone.cryptic.systems/volker.raschek/postfix-policyd-spf-perl-pkg)
+![AUR votes](https://img.shields.io/aur/votes/postfix-policyd-spf-perl)
+
+This repository contains build files to build the Arch Linux package `postfix-policyd-spf-perl`. Instead of building the
+package yourself, it can also be obtained from the following private repository. More detailed are described
+[here](#obtaining-pre-built-packages-from-a-repository).
+
+## Build
+
+Clone this repository and use `makepkg` to build the package by yourself. For example:
+
+```bash
+git clone https://aur.archlinux.org/postfix-policyd-spf-perl.git
+cd postfix-policyd-spf-perl
+makepkg
+```
+
+## Yay
+
+The build files are also available via AUR and can be installed via an AUR helper like `yay`.
+
+```bash
+yay --sync --aur postfix-policyd-spf-perl
+```
+
+## Obtaining pre-built packages from a repository
+
+Instead of building the packages locally, it is also possible to configure an additional repository to install the
+package directly via `pacman`. The following commands are used to create the repository, configure the GPG key to verify
+the packages and install the package:
+
+```bash
+# Create drop-in directory
+sudo mkdir --parents /etc/pacman.d/repos
+
+# Create configuration of the repository 'volker.raschek'
+sudo tee /etc/pacman.d/repos/volker.raschek.conf > /dev/null <<'EOF'
+[volker.raschek]
+SigLevel = PackageRequired TrustedOnly
+Include = /etc/pacman.d/repos/volker.raschek.list
+EOF
+
+# Create mirror list of the repository 'volker.raschek'
+sudo tee /etc/pacman.d/repos/volker.raschek.list > /dev/null <<'EOF'
+Server = https://aur.cryptic.systems/$repo/$arch
+EOF
+
+# Import gpg key of the repository 'volker.raschek'
+sudo pacman-key --keyserver hkps://keys.openpgp.org --recv-keys 9B146D11A9ED6CA7E279EB1A852BCC170D81A982
+
+# Extend existing pacman configuration of the repository 'volker.raschek'
+sudo echo "Include = /etc/pacman.d/repos/*.conf" >> /etc/pacman.conf
+
+# Update pacman cache
+sudo pacman --sync --refresh
+
+# Install the package and receive updates directly via pacman :)
+sudo pacman --sync postfix-policyd-spf-perl
+```