Build a TetherBox on Your Own Hardware
https://applewood.timeline.is/help/integrators/build-your-own-tetherbox
Last updated: November 06, 2026
Table of Contents

Build a TetherBox on Your Own Hardware

For a trial, run the TetherBox software on hardware you already have. Choose one of the two routes below. Once the host is online, TetherX completes the installation remotely.

 Choose a Build Route

Choose a Linux or VirtualBox route for a TetherBox trial

 Install Linux Directly

Set up the host with the operating system, network access and temporary account TetherX needs to complete the installation.

For a direct Linux installation, prepare:

  • Hardware and recording storage sized for the site. See Hardware Specifications and Storage Hardware Recommendations.
  • A working Internet connection.
  • SSH enabled and reachable by TetherX for the software installation.
  • A temporary account with sudo access. TetherX removes this account when the installation is complete.

For a new compact demonstration unit, see Compact TetherBox Demo Build and its Australian, Canadian and UK component examples. The shared guide covers compatibility and recording assumptions before you choose a regional supplier.

 Prepare an x86 Host

Install Ubuntu Server 26.04 LTS (opens in a new tab) on Intel or AMD hardware. Download the 64-bit PC (AMD64) server install image from that release page. Use a minimal server installation without a desktop environment.

Warning: TetherBox requires Ubuntu Server LTS (Long Term Support). Ubuntu 26.10 and other non-LTS releases are not supported for TetherBox installations. Choose the LTS release even when a newer non-LTS version is available.

A compact mini PC suits a smaller deployment. A Mini-ITX or compact micro-ATX build can add a dedicated GPU without a full-size tower; choose rackmount hardware where storage bays or expansion needs justify it.

Compact x86 mini PC, suitable for smaller deployments 2U rackmount server, suitable for higher-capacity deployments

Create these partitions during installation:

Mount point Format Minimum size Purpose
/ ext4 8 GB Operating system and TetherX software
swap swap 2 GB System memory swap
/data ext4 Largest available space Footage and recording data

Increase the root partition if the host will run other services. Keep recording storage separate from the operating-system drive where possible.

Before you hand the host over, configure its BIOS for unattended operation: automatic power-up after a power cut, the internal drive first in the boot order, Secure Boot disabled (recommended, not required) and, on boards that need it, the hardware watchdog enabled. See BIOS Settings for every setting.

If you keep the Ubuntu installer's default LVM layout instead, the installer gives the root volume only part of the disk. The TetherX installation grows that volume into the rest of the disk, provided it is the only volume in its group and is formatted ext4, so footage can use the whole drive.

Check Component Compatibility

Before ordering a custom build, check:

  • The exact CPU socket, motherboard revision and minimum BIOS, plus how that BIOS can be installed.
  • RAM type and supported capacity; allow for AI memory use as well as the recording baseline.
  • NVMe and SATA support, shared lanes or disabled ports, and the remaining storage connections after fitting an accelerator.
  • GPU length, height, thickness and power-plug clearance, plus the actual electrical PCIe lane width available with the chosen CPU.
  • PSU capacity, dimensions and required motherboard, CPU, GPU and drive connectors.
  • CPU cooler height, drive mounts and usable fan positions with every component fitted. Include the cooler, thermal compound and required fans, counting any supplied parts first.
  • SATA data cables, drive power, mounting hardware, an Australian mains lead for Australian deployments and an Ethernet patch cable.

For CPUs without integrated graphics, connect the setup monitor to the dedicated GPU. Confirm that the TetherBox installation supports the chosen accelerator and its driver. For a Hailo module, see Interface Requirements.

 Prepare a Raspberry Pi

Use Raspberry Pi Imager (opens in a new tab) to install Raspberry Pi OS (64-bit) Lite. Raspberry Pi 4 and Raspberry Pi 5 are supported.

Raspberry Pi 5 with an AI HAT installed

Before writing the card, open the Imager customisation settings and:

  1. Enable SSH.
  2. Create a tetherx user with a secure temporary password.
  3. Set the network details needed for the first boot.

Use the official power adapter with Raspberry Pi 5. Do not use the MicroSD card for continuous video recording. Add suitable USB or M.2 storage, as described in Raspberry Pi TetherBox and Storage Hardware Recommendations.

Warning: A MicroSD card is suitable for the operating system, not continuous video recording. Use suitable USB or M.2 storage for footage.

 Let TetherX Complete the Installation

For a first unit, temporary SSH access is the easiest way for TetherX to complete the setup. Distributors can then have their local demo unit configured as a Deployment TetherBox to assemble and preload customer units themselves, by preparing drives or deploying over SSH on their local network. Those installations do not require public SSH access to customer units. See Prepare Customer Units Locally for the workflow.

Once the host is online, contact TetherX with:

  • The public IP address or hostname.
  • SSH port, if it is not the default port 22.
  • The temporary username and password.

TetherX connects to the host, installs the software and removes the temporary account. Keep the host powered on and connected until the work is complete.

Tip: The temporary account is removed as part of software installation. Use an account created only for this handover.

 Attach Recording Storage

TetherX writes footage below this path:

/data/{site-name}/{tetherbox-serial}/{partition-id}

Each suitable storage device appears as a partition ID. TetherX spreads footage across available devices, so a failure of one does not remove every minute of a recorded event.

For one RAID or NAS volume, mount it here instead:

/data/{site-name}/{tetherbox-serial}/internal

 Run the VirtualBox Appliance

Use this route when you have an existing Windows desktop or server and prefer not to install Linux.

  1. Install Oracle VirtualBox (opens in a new tab) on the host.
  2. Import the TetherBox appliance image (.ova) supplied by TetherX.
  3. Set the virtual machine to bridged networking and add a recording disk.
  4. Start it, then activate the TetherBox.

Follow the VirtualBox guide for the full steps and screenshots.

Last updated: November 06, 2026