diff --git a/_toc.yml b/_toc.yml
index 6336e0c5..2b44b812 100644
--- a/_toc.yml
+++ b/_toc.yml
@@ -140,6 +140,10 @@ chapters:
- file: rhel8/desktop
- file: rhel8/vendor_documentation
+ - file: rhel9/index
+ sections:
+ - file: rhel9/installation
+
- file: services-user-guide/index
sections:
- file: services-user-guide/ssh_gateways
diff --git a/rhel9/index.md b/rhel9/index.md
new file mode 100644
index 00000000..63cfb47c
--- /dev/null
+++ b/rhel9/index.md
@@ -0,0 +1,56 @@
+# Red Hat Enterprise Linux 9
+
+## Alpha Testing
+
+We encourage you to install RHEL9 on testing systems and tell us what we may have broken, what bugs you run into and what features you are missing. Please be aware of certain things we changed on how we want the base operating system to work, listed below.
+
+Bugs and issues can be reported in the [Linux project in JIRA](https://jira.psi.ch/browse/PSILINUX).
+
+Additional ressource [Considerations in adopting RHEL 9](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html-single/considerations_in_adopting_rhel_9/index#doc-wrapper)
+
+## Changes for Base Installation
+
+### Workstation Package Groups
+Changed the ammount of packages installed by default on workstation installation. See the comparison below:
+
+| RHEL 7&8 | RHEL 9 |
+| --- | --- |
+|
- VMware platform specific packages (platform-vmware)
- Container Management (container-management)
- Internet Browser (internet-browser)
- GNOME (gnome-desktop)
- Headless Management (headless-management)
- Server product core (server-product)
- Hardware Monitoring Utilities (hardware-monitoring)
- base-x (base-x)
- core (core)
- fonts (fonts)
- guest-desktop-agents (guest-desktop-agents)
- hardware-support (hardware-support)
- input-methods (input-methods)
- multimedia (multimedia)
- networkmanager-submodules (networkmanager-submodules)
- print-client (print-client)
- standard (standard)
| - Internet Browser
- VMware platform specific packages (platform-vmware)
- GNOME (gnome-desktop)
- Core (core)
- fonts (fonts)
- multimedia (multimedia)
- office-suite (office-suite)
- print-client (print-client)
|
+
+
+### Disk Layout
+Provided disk size is 64GB for virtual machines.
+
+| Name | Path | Size | Type | LVM |
+| --- | --- | --- | --- | --- |
+| root | / | 16GB | xfs | yes |
+| home | /home | 2GB | xfs | yes |
+| tmp | /tmp | 2GB | xfs | yes |
+| var | /var | 16GB | xfs | yes |
+| log | /var/log | 4GB | xfs | yes |
+| boot | /boot | 1GB | ext4 | no |
+| swap | - | 4GB | swap | no |
+
+### No Support for AFS
+After long conciderations we came to the conclusion that AFS won't be maintainable in PSI in the near future. For that reason we decided to stop supporting AFS starting with RHEL 9 and find other solutions wherever needed.
+
+### Tracking Epic
+https://jira.psi.ch/browse/PSILINUX-287
+
+## Caveats
+
+### Missing or Replaced Packages
+
+[List of packages removed in RHEL 9](https://access.redhat.com/documentation/en-us/red_hat_enterprise_linux/9/html-single/considerations_in_adopting_rhel_9/index#removed-packages_assembly_changes-to-packages)
+
+| RHEL 8 | RHEL 9 | Remarks |
+| --- | --- | --- |
+| `mailx` | `s-nail` | S-nail is MIME capable and has extensions for line editing, S/MIME, SMTP, IMAP, POP3, and more. |
+| `platform-python, python2 (python27:2.7), python36 (python36:3.6), python38 (python38:3.8), python39 (python39:3.9)` | `python3` | As for all python* packages |
+| `pulseaudio` | `pipewire-pulseaudio` | The pulseaudio server implementation has been replaced by the pipewire-pulseaudio implementation. Note that only the server implementation has been switched. The pulseaudio client libraries are still in use. |
+| `inkscape1` | `inkscape` | Also affects `inkscape-docs` and `inkscape-view` |
+
+
+### Documenatation
+
+* [Installation](installation)
diff --git a/rhel9/installation.md b/rhel9/installation.md
new file mode 100644
index 00000000..83ec8c3d
--- /dev/null
+++ b/rhel9/installation.md
@@ -0,0 +1,21 @@
+# Installation
+
+## Minimal HW/VM Requirements
+- 4GB RAM
+- 64GB Disk
+
+## Network Installation
+
+The machine you want to install needs to be [registered in `sysdb`](../admin-guide/deployment/sample).
+
+Optional you can set `netboot` and RHEL 9 installer but that can also be selected manually in be boot menu:
+
+```
+bob node netboot $FQDN
+bob node set-attr $FQDN ipxe_installer=rhel9install
+```
+### Installation with UEFI
+Start the machine and select network boot
+
+### Installation with Legacy BIOS
+Not supported yet