-====================================
-Setup PVE Development Environment
-====================================
-
-1. Install Debian 'jessie'
-2. Configure pvetest repository in apt sources.list
-3. make sure you have a read IP address for your hostname in /etc/hosts
- (using 127.0.1.1 will not work)
-3. run: apt-get update
-3. run: apt-get dist-upgrade
-4. run: apt-get install proxmox-ve-3.10.0
-
-5. Install prerequisites for development environment:
-
-# new jessie depends
-
-apt-get -y install build-essential git-core debhelper autotools-dev \
-autogen dh-autoreconf dkms doxygen check pkg-config groff quilt dpatch \
-automake autoconf libtool lintian libdevel-cycle-perl libjson-perl \
-libcommon-sense-perl liblinux-inotify2-perl libio-stringy-perl \
+= Setup PVE Development Environment =
+
+0. Read https://pve.proxmox.com/wiki/Developer_Documentation
+1. Install Debian 9 'stretch' (you can also start from a PVE installation and
+ skip step 2 - 5, 7 - 11)
+2. Configure the network interface(s)
+3. Change the IP address of your hostname for proper name resolution
+ in /etc/hosts
+ Using 127.0.1.1 will not work, so change it to an IP address from your
+ local network!
+
+4: Check that the Debian repositories are set properly.
+ See https://wiki.debian.org/SourcesList for more information.
+
+5. Optional: Install openssh-server and connect via ssh to the host.
+
+ run: apt-get update && apt-get install openssh-server
+ Connect via ssh to host and switch user to root
+
+6. Configure 'pvetest' repository in /etc/apt/sources.list.d/:
+
+ run: echo "deb http://download.proxmox.com/debian stretch pvetest" > /etc/apt/sources.list.d/pve-development.list
+
+7. Add the repository key:
+
+ run: wget -O- "http://download.proxmox.com/debian/proxmox-ve-release-5.x.gpg" | apt-key add -
+
+8. run: apt-get update && apt-get dist-upgrade
+9. run: apt-get install proxmox-ve
+10. run: mv /etc/apt/sources.list.d/pve-enterprise.list /etc/apt/sources.list.d/pve-enterprise.list.bak
+
+11. You should now have a working Proxmox VE installation.
+ Open a browser: https://<host_IP_address>:8006 e.g. https://10.0.0.90:8006
+
+
+= Install build prerequisites for development environment =
+
+NOTE: this is a huge list intended to be able to build (almost) all packages,
+from the UI/API components to backend components to our Linux Kernel.
+If you only want to hack on specific topics you won't need most of those.
+We try to have a complete list of build dependencies in each source
+repositories 'debian/control' file. If you run `make deb` dpkg-buildpackage will
+stop and tell you if you miss some required packages.
+
+12. For installing the most important, always needed, ones run:
+
+apt-get install build-essential git git-email debhelper pve-doc-generator
+
+Additionally, for quickly installing (almost) all build dependencies run:
+
+apt-get install autotools-dev autogen dh-autoreconf dkms doxygen check pkg-config \
+groff quilt dpatch automake autoconf libtool lintian libdevel-cycle-perl \
+libjson-perl libcommon-sense-perl liblinux-inotify2-perl libio-stringy-perl \