Install tgarr

Download one file and double-click it. No terminal, no account of any kind to begin.

tgarr is Linux software in containers. On Linux the installer starts them. On Windows and on a Mac there is no way around a small Linux underneath - every "Docker for the desktop" is one - so the installer sets it up for you and puts tgarr inside. You get a page at http://localhost:8765; what runs underneath need not concern you again. It keeps itself up to date.

It needs about 3 GB of disk to begin with (about 600 MB is downloaded), and 4 GB of memory to spare. On Linux, when the machine has an Intel or NVIDIA graphics card, films are converted on it.

Windows 10 and 11 run on a Windows 11 PC

Download install-tgarr.cmd · 1 kB

  1. Double-click the file. Windows may say it is not commonly downloaded, or "Windows protected your PC" - it says that of every script no company has paid to sign. More info → Run anyway. The file is a few lines; open it in Notepad to read them.
  2. Say Yes when Windows asks whether the installer may make changes.
  3. If WSL2 - the Linux that Windows carries - is not switched on yet, it is switched on and Windows restarts once. When you have logged in again the installation goes on by itself (and asks for permission once more).
  4. It installs tgarr and asks whether the other devices at home may reach it. Enter is yes: phones, tablets and televisions on your home network can then open it - never anything from the internet.
  5. The browser opens on tgarr.

It starts with Windows, in the background, before anybody logs in. Its files are at \\wsl$\Ubuntu\opt\tgarr in Explorer. Windows 10 needs version 2004 or later.

macOS new - not yet run on a real Mac

Download install-tgarr-macos.zip · 1 kB

  1. It needs Homebrew. If you do not have it, install it first (one line, on its site).
  2. Open the zip and right-click install-tgarr.command → Open (the first time; macOS does not open an unsigned file on a double-click).
  3. It installs Colima - a small Linux machine with Docker in it - starts it, has it start again at login, and installs tgarr inside.

What tgarr fetches is put in ~/tgarr/downloads, where Finder sees it. This installer has been written with care and tried piece by piece, but nobody has yet run the whole of it on a Mac: if you do, tell us what it printed.

Linux run on a new Ubuntu 24.04

curl -fsSL https://raw.githubusercontent.com/tgarrpro/tgarr/main/install/install.sh | bash

It installs into ~/tgarr. If Docker is missing it asks before installing it. On a NAS - Synology, QNAP, Unraid, TrueNAS, CasaOS - use the two files and docker compose up -d instead: the README says how.

On the television, and on a phone

Afterwards

What the installers do not do: they install nothing but tgarr and what it runs on, hide nothing they do, and send nothing anywhere. Each is a short script you can read before running - here they are.