From 6fa752b7c5b7675a147bd7c0a3e887d2a8c9022c Mon Sep 17 00:00:00 2001
From: Joseph Nuthalapati <njoseph@riseup.net>
Date: Fri, 1 May 2020 17:50:49 +0530
Subject: [PATCH] HACKING: More detailed instructions for VirtualBox

Add more detailed instructions for installing VirtualBox manually on
Debian and its derivatives.

Signed-off-by: Joseph Nuthalapati <njoseph@riseup.net>
Reviewed-by: Sunil Mohan Adapa <sunil@medhas.org>
---
 HACKING.md | 31 ++++++++++++++++++++++++++++---
 1 file changed, 28 insertions(+), 3 deletions(-)

diff --git a/HACKING.md b/HACKING.md
index 422d0a080..e080286ed 100644
--- a/HACKING.md
+++ b/HACKING.md
@@ -15,14 +15,39 @@ can install latest versions of Git, Vagrant and VirtualBox.
    $ sudo apt install git virtualbox vagrant
    ```
 
-   For some distro you might need to add Oracle's VirtualBox source
-   (https://download.virtualbox.org/virtualbox/debian) to apt's sources list
-   (typically in /etc/apt/sources.list file) and its key:
+#### Installing VirtualBox manually
+
+1. Add Oracle's key to apt's list of accepted keys.
 
    ```bash
    $ sudo wget -q https://www.virtualbox.org/download/oracle_vbox_2016.asc -O- | sudo apt-key add -
    ```
 
+2. Create a file under /etc/apt/sources.list.d/ for virtualbox package.
+
+
+   ```bash
+   $ sudo touch /etc/apt/sources.list.d/virtualbox.list
+   ```
+
+3. Add the relevant source for your Debian/derivative distribution into the above file.
+
+Example for Buster:
+   ```
+   deb https://download.virtualbox.org/virtualbox/debian buster contrib
+   ```
+
+4. Search and install the latest virtualbox package.
+
+   ```bash
+   $ apt search virtualbox
+
+       # virtualbox-6.1
+       # virtualbox-6.0
+
+   $ sudo apt install virtualbox-6.1
+   ```
+
 ### For Other GNU/Linux Distributions or *BSDs
 
 1. Install Git, Vagrant and VirtualBox using your favourite package manager.