diff --git a/readme.md b/readme.md
new file mode 100644
index 0000000..0a379a5
--- /dev/null
+++ b/readme.md
@@ -0,0 +1,43 @@
+# Installation of zsh (z-shell) with oh-my-zsh in Arch Linux
+
+## Preparation
+
+You would like to install the package manager `yay` instead of `pacman` first:
+
+#### Yay installation
+
+```
+sudo pacman -S --needed git base-devel
+git clone https://aur.archlinux.org/yay.git
+cd yay
+makepkg -si
+```
+You can find support at https://github.com/Jguer/yay
+
+#### Installation
+
+```
+yay oh-my-zsh
+```
+
+#### Configuration
+
+Copy the file `smd.zsh-theme` of this repository to the `themes` directory, like
+```
+sudo wget -P /usr/share/oh-my-zsh/themes https://git.kuschel.at/public/smd.zsh-theme/releases/download/1.0/smd.zsh-theme
+```
+Then copy the zsh template `zshrc` to your home directory
+```
+cp /usr/share/oh-my-zsh/zshrc ~/.zshrc
+```
+Now you have to edit this file with e.g. `nano -cl ~/.zshrc`
+an` replace the line with ZSH_THEME to:
+```
+ZSH_THEME="smd"
+```
+In addition, I like to replace the HIST_STAMPS to:
+```
+HIST_STAMPS="yyyy-mm-dd"
+```
+
+-- eof --
\ No newline at end of file