Getting started

Install Trekport.

Trekport ships as a desktop application and a command-line interface. Both surfaces drive the same engine. Choose the one that fits the team.

Pick a surface

Surface	Best for	Distribution
Trekport Studio (desktop)	Operators driving a single estate, demo runs, visual review of the deployment.	Signed installer per platform.
Trekport CLI	CI pipelines, scripted automation, headless servers, air-gapped operations.	Single static binary per platform.

Confirm your host meets the system requirements before installing either surface.

Trekport Studio (desktop)

The desktop application installs through a signed installer for each host platform. Installers are signed and notarized so they pass platform security checks by default.

Platform	Installer	Install path
macOS	`Trekport-Studio.dmg`	Drag into `/Applications`, then launch.
Windows	`Trekport-Studio.msi`	Run the MSI. Adds Start Menu entry and desktop shortcut.
Linux	`Trekport-Studio.AppImage`	Mark executable and run. Self-contained.

Trekport CLI

The command-line interface ships as a single static binary per platform. There is no runtime to install, no virtual environment to manage, and no language toolchain to keep on the host. Drop the binary on the system PATH and run it.

Linux and macOS

install-trekport-cli.shbash

# Replace the URL with the signed binary for your platform.
curl -fsSL https://trekport.sh/cli/latest/linux-amd64/trekport \
  -o /usr/local/bin/trekport
chmod +x /usr/local/bin/trekport

trekport --version

Windows (PowerShell)

install-trekport-cli.ps1powershell

# Run from an elevated PowerShell prompt.
Invoke-WebRequest `
  -Uri "https://trekport.sh/cli/latest/windows-amd64/trekport.exe" `
  -OutFile "C:\Program Files\Trekport\trekport.exe"

# Add C:\Program Files\Trekport to PATH, then:
trekport --version

Air-gapped install

Both surfaces support an air-gapped install. Download the installer and the compatibility-layer extensions to a staging host, transfer the bundle across the airgap, and install from the local files. License verification works offline against a pre-issued license file.

Verify the install

After installing either surface, run the version command. The binary prints its semver, the engine commit, and the supported target PostgreSQL versions.

bash

$ trekport --version
trekport 0.9.0 (engine 4d2c1e8)
Supports PostgreSQL 14, 15, 16, 17, 18

Updates

Updates flow through the OS package manager or the same signed installer channel. There is no required phone-home update channel. Air-gapped customers update by transferring the next installer bundle.