| .. | ||
| base | ||
| readme.md | ||
Running SDRangel in a Docker container
⚠ This is highly experimental and subject to large changes. Do not expect it to work in all cases.
Because SDRangel uses OpenGL this can make it possibly more difficult to run it properly on some hosts and operating systems. Some particular implementations can be derived fom a base GUI image (see "Folders organization" and "Building images" paragraphs).
Install Docker
This is of course the first step. Please check the Docker related page and follow instructions related to your system.
Windows
In Windows you have two options:
- Install with Hyper-V: Hyper-V is a bare-metal type hypervisor where the Windows O/S itself runs in a VM. The catch is that it requires Windows 10 Pro version and a special set up. This is required to install _ Docker Desktop for Windows_ In this configuration a docker instance runs in its own VM
- Install with Oracle Virtualbox: Virtualbox is a hosted type hypervisor that sits on the top of the Windows O/S so it puts an extra layer on the stack but may be available on more flavors of Windows. In this case you will install Docker in a Linux O/S Virtualbox VM for example Ubuntu 18.04 and therefore you will have to follow Linux instructions.
See this discussion about the difference between Hyper-V and Virtualbox.
Get familiar with Docker
The rest of the document assumes you have some understanding on how Docker works and know its most used commands. There are tons of tutorials on the net to get familiar with Docker. Please take time to play with Docker a little bit so that you are proficient enough to know how to build and run images, start containers, etc... Be sure that this is not time wasted just to run this project. Docker is a top notch technology (although based on ancient roots) widely used in the computer industry and at the heart of many IT ecosystems.
Folders organization
This is a hierarchy of folders corresponding to an image build hierarchy. At each node building an image may be possible based on the image built previously. A terminating node always builds a final runnable image.
base
this creates a bionic/sdrangel:base image that is used as a base for all images. It takes an Ubuntu 18.04 base, performs all necessary packages installations then eventually compiles and installs all specific software dependencies
base/gui
this creates a bionic/sdrangel:gui image from the base image is used as a base for all GUI images. Essentially it compiles and installs SDRangel GUI flavor.
base/gui/vanilla
this creates a bionic/sdrangel:vanilla runnable image from the GUI base image to be used on systems without any specific hardware requirements.
base/gui/linux
Linux specific host implementations
base/gui/linux/nvidia
Creates a bionic/sdrangel:linux_nvidia runnable image based on the base GUI image to be used on Linux systems with NVidia proprietary drivers
base/server
this creates a bionic/sdrangel:server runnable image from the base image to be used to run SDRangel server flavor. Essentially it compiles and installs SRangel server flavor.
Building images
Each build folder contains a Dockerfile to create an image and a script build.sh to actually build the image and tag it with its specific tag. To build an image you first cd to the appropriate folder.
You will proceed by running the build.sh script if it exists at each node in the folder hierarchy path until you reach the final image. The possible use cases corresponding to a particular path are the following:
- GUI flavor without specific hardware requirements:
base/gui/vanilla - GUI flavor on Linux systems with NVidia proprietary drivers:
base/gui/linux/nvidia - Server flavor:
base/server
Note: for now all images are to be run in a x86_64 environment.
Running images
Each terminal folder in the path hierarchy corresponds to a runnable image and therefore contains a run.sh script to be executed to start a container with the corresponding image.