From a3929f29976df397021a20d9a2ba7152bcb5a760 Mon Sep 17 00:00:00 2001 From: krakenrf <78108016+krakenrf@users.noreply.github.com> Date: Fri, 26 Aug 2022 23:13:47 +1200 Subject: Updated 10. VirtualBox and Docker Images (markdown) --- ...irtualBox,-Docker-Images-and-Install-Scripts.md | 45 ++++++++++++++++++++++ 10.-VirtualBox-and-Docker-Images.md | 24 ------------ 2 files changed, 45 insertions(+), 24 deletions(-) create mode 100644 10.-VirtualBox,-Docker-Images-and-Install-Scripts.md delete mode 100644 10.-VirtualBox-and-Docker-Images.md diff --git a/10.-VirtualBox,-Docker-Images-and-Install-Scripts.md b/10.-VirtualBox,-Docker-Images-and-Install-Scripts.md new file mode 100644 index 0000000..96457ae --- /dev/null +++ b/10.-VirtualBox,-Docker-Images-and-Install-Scripts.md @@ -0,0 +1,45 @@ +## VirtualBox + +We currently have a [VirtualBox](https://www.virtualbox.org/wiki/Downloads) virtual machine image that is in beta. The image is based on Ubuntu 22.04 and has the KrakenSDR Direction Finding, KrakenSDR Passive Radar, and GNU Radio with KrakenSDR Source block preinstalled. + +Download Here: https://drive.google.com/file/d/1FZZvOoRB9G7t5qgX-BnsGGBu40gg8bwn/view?usp=sharing + +username/password: krakenrf/krakensdr + +The image is provided as an OVA file, so in VirtualBox go to File->Import to use it. Make sure you deselect the network interface upon install, and then before starting set networking to bridged mode, and select your own network interface on your host. + +Note that this uses the VirtualBox USB3.0 implementation as we have found that the USB2.0 implementation is too slow and drops samples. The USB3.0 implementation works well. In order to use the USB3.0 implementation you will need the Oracle VM VirtualBox Extension Pack from https://www.virtualbox.org/wiki/Downloads installed to your VirtualBox. + +We recommend allocating 8GB of RAM and 4 CPU cores to the system. We have tested the image on a 6th gen and 11th gen intel CPU. The 6th gen runs the DOA software well and PR software well but not at full speed. The GNU Radio code struggles to keep up on 6th gen. The 11th gen is capable of handling everything. + +**Linux Hosts NOTE:** Note that on Linux hosts you will need to run the following command first, in order to allow for USB pass through to work. + +``` +sudo adduser $USER vboxusers +``` +## Docker + +Third parties have created a Docker container that you can use for installing a ready to use image of the DOA software. Note that the Docker container will not work on Windows, due Docker not supporting USB passthrough from Windows to a Linux image. Also note that the Docker container is immutable, so any settings changes you save will not persist once the image is restarted. + +Docker Image Repository: https://github.com/godsic/krakensdr-containers/ + +## Install Scripts + +These scripts will automatically install the drivers, all dependencies and the DOA and PR software packages in `krakensdr_doa` and `krakensdr_pr` folders. + +Start the software with the start scripts in the `krakensdr_doa` and `krakensdr_pr` folders. + +Note that the scripts may ask for your system password a few times if your system is slow. So please keep an eye on the script. + +### x86 64 Bit Systems +``` +wget https://raw.githubusercontent.com/krakenrf/krakensdr_docs/main/install_scripts/krakensdr_x86_install_doa_pr.sh +sudo chmod +x krakensdr_x86_install_doa_pr.sh +./krakensdr_x86_install_doa_pr.sh +``` +### ARM64 Systems +``` +wget https://raw.githubusercontent.com/krakenrf/krakensdr_docs/main/install_scripts/krakensdr_aarch64_install_doa_pr.sh +sudo chmod +x krakensdr_aarch64_install_doa_pr.sh +./krakensdr_aarch64_install_doa_pr.sh +``` \ No newline at end of file diff --git a/10.-VirtualBox-and-Docker-Images.md b/10.-VirtualBox-and-Docker-Images.md deleted file mode 100644 index a6d549f..0000000 --- a/10.-VirtualBox-and-Docker-Images.md +++ /dev/null @@ -1,24 +0,0 @@ -## VirtualBox - -We currently have a [VirtualBox](https://www.virtualbox.org/wiki/Downloads) virtual machine image that is in beta. The image is based on Ubuntu 22.04 and has the KrakenSDR Direction Finding, KrakenSDR Passive Radar, and GNU Radio with KrakenSDR Source block preinstalled. - -Download Here: https://drive.google.com/file/d/1FZZvOoRB9G7t5qgX-BnsGGBu40gg8bwn/view?usp=sharing - -username/password: krakenrf/krakensdr - -The image is provided as an OVA file, so in VirtualBox go to File->Import to use it. Make sure you deselect the network interface upon install, and then before starting set networking to bridged mode, and select your own network interface on your host. - -Note that this uses the VirtualBox USB3.0 implementation as we have found that the USB2.0 implementation is too slow and drops samples. The USB3.0 implementation works well. In order to use the USB3.0 implementation you will need the Oracle VM VirtualBox Extension Pack from https://www.virtualbox.org/wiki/Downloads installed to your VirtualBox. - -We recommend allocating 8GB of RAM and 4 CPU cores to the system. We have tested the image on a 6th gen and 11th gen intel CPU. The 6th gen runs the DOA software well and PR software well but not at full speed. The GNU Radio code struggles to keep up on 6th gen. The 11th gen is capable of handling everything. - -**Linux Hosts NOTE:** Note that on Linux hosts you will need to run the following command first, in order to allow for USB pass through to work. - -``` -sudo adduser $USER vboxusers -``` -## Docker - -Third parties have created a Docker container that you can use for installing a ready to use image of the DOA software. Note that the Docker container will not work on Windows, due Docker not supporting USB passthrough from Windows to a Linux image. Also note that the Docker container is immutable, so any settings changes you save will not persist once the image is restarted. - -Docker Image Repository: https://github.com/godsic/krakensdr-containers/ \ No newline at end of file -- cgit v1.2.3