You must have a device based on an Intel CPU architecture. It must support Ubuntu 20.04 LTS. If you have concerns about your hardware please contact your hardware vendor and ask about their support for Ubuntu. If additional drivers are required TelemetryOS will not work since it is locked down and there is no ability to add drivers to the operating system.
This device will be dedicated to TelemetryOS. Installing TelemetryOS will wipe out anything else you have on this device.
TelemetryOS requires a mimimum of 4GB of RAM and 32GB of storage. You should also have at least a dual core and relatively modern CPU. WiFi is optional and we recommend you use ethernet instead for network stability.
We highly recommend the Fitlet2 as the hardware platform of choice. We've tested it and found it to be an inexpensive and reliable device.
You'll need to obtain a USB3 drive for installation on one or more devices. Please make sure you buy a USB3 (not USB or USB2) drive for performance reasons. Use the blue USB3 port on the computer. If you dont do this then installation can be quite slow.
Please follow the installation steps below to install on your device.
1. Download ISO
Download the TelemetryTV ISO from the download link below to your Mac, Linux or Windows desktop computer.
2. Download Balena Etcher
You'll use Balena Etcher to 'burn' the ISO image to your USB3 Drive. Download this and install it on your desktop computer.
3. Burn ISO File
Follow the instructions within Balena Etcher and burn the ISO image to your USB drive. Once complete remote the USB drive from your computer.
4. BIOS Generic settings
Connect HDMI and keyboard to your device. Insert the USB key in to the USB3 socket (blue socket) in the device. Turn on your device and press Del or Esc button to enter into BIOS settings (keys might differ for some devices).
4.1 Configure USB (if applicable) and Storage (if applicable) to UEFI only (no Legacy). Usually those setting can be found in BIOS Advanced Menu -> Compatibility Support Module (CSM).
4.2 Configure OS Selection to Linux. Usually this option can be found in BIOS Chipset Menu.
4.3 Configure to boot from USB first. Usually it is BIOS Boot menu under Boot options. You will need to place UEFI: USB disk to be first in priority to boot.
5. Boot Device From USB
Turn off your device you're going to be installing TelemetryOS. Connect HDMI and do NOT connect ethernet network cable to the device until TelemetryOS is fully installed from USB key. Insert the USB key in to the USB3 socket (blue socket) in the device. Please be aware that installing TelemetryOS will wipe out anything else on the device.
Wait for the device to boot from the USB drive.
6. Install TelemetryOS
Select Install TelemetryTV OS or just wait and after 5 sec the installation will start automatically. Wait several minutes for the installation process to complete. The device will shut down once installation is complete successfully.
Remove USB key.
Connect ethernet network cable (if device will be wired).
7. Start up Device
Start up the device and let it boot. It will show the configuration screen. Configure the WiFi or ethernet. Ensure that the networking says active before continuing. You may provision at this point or complete in order to pair.
Note that if you dont want to use WiFi and then plug in an ethernet connection the setup screen will auto-advance to the pairing screen after a 30 second timeout.
You're now ready to use the device.
Returning to Setup Screen
If you need to return to the setup screen at any time you can right click to get the application menu or press ctrl-s on an attached keyboard to show the setup screen.