Skip to content

GT Edge AI Operating System Gen 3 Self Hosted Installation

tbendien edited this page Jun 23, 2026 · 1 revision

Install — Local LAN

Install GT AI OS on a single host so operators open Control Panel and the tenant app on the node LAN IP over HTTPS ports 3001 and 3002.

← Back to installation hub


Prerequisites

  • Static LAN IP for the node (recommended for dedicated servers)
  • Outbound HTTPS to GitHub Releases and ghcr.io/gt-edge-ai
  • Shared prerequisites (Ubuntu or DGX, storage, and so on)

For a roaming Linux laptop instead of a fixed server IP, use Install — Local Portable.


1. Install the Quick Installer

To pin a release, set TAG before download (for example TAG=v3.0.4). The .deb filename uses semver without the v prefix (3.0.4 for tag v3.0.4).

TAG="$(curl -fsSL https://api.github.com/repos/GT-Edge-AI/GT-AI-OS/releases/latest | grep '"tag_name"' | head -1 | cut -d'"' -f4)"
VER="${TAG#v}"
curl -fsSL -o /tmp/gt-ai-os.deb \
  "https://github.com/GT-Edge-AI/GT-AI-OS/releases/download/${TAG}/GT-AI-OS-Quick-Installer_${VER}_all.deb"
sudo apt install -y /tmp/gt-ai-os.deb
sudo -E gt-ai-os-operator

2. Operator menu

When the operator menu appears, choose the following:

When you see Choose
What do you want to do? 1 (Install)
Install — choose style 1 (Interactive)

3. Install wizard

Complete the shared wizard steps, then use these ingress-specific answers:

When you see Choose or enter
Control Panel — access model 1 (LAN only)
Tenant App — access model 1 (LAN only)
Control Panel LAN host (no https://, no :3001) Node LAN IP (for example 192.168.1.50), or accept autodetected IP
Tenant App LAN host Same IP (Enter) or a different LAN host if needed

The wizard may autodetect the node LAN IP and skip manual entry. Accept the detected value when it matches your static server IP.

After your last answer above, the install runs automatically. Expect about 15 minutes before the wizard finishes. Do not interrupt the terminal.

Save the bootstrap Control Panel email and password printed when the install finishes.


4. Log in to Control Panel

  1. Open https://<lan-ip>:3001/login in your browser (use the LAN IP from the wizard).
  2. Sign in with the bootstrap email and password from step 3.

Accept the browser self-signed certificate warning.

To print bootstrap credentials again:

sudo env GT_AI_OS_ADMIN_CONFIG_DIR=/var/lib/gt-ai-os/admin \
  PATH="/var/lib/rancher/rke2/bin:/usr/local/bin:$PATH" \
  gt-ai-os-admin bootstrap-creds --namespace <your-namespace>

Tenant app URL: https://<lan-ip>:3002/login


Next step

Self-Hosted Control Panel setup

Clone this wiki locally