GTEdgeAI/gt-ai-os-community
3
0
Fork 0
Code Issues Packages Releases Wiki Activity
Page: Updating
Pages
Cloudflare Tunnel Setup Control Panel Guide Home How to build GT AI OS Agents Installation Ollama Setup Projects for NVIDIA NIMs and Nemotron using Local Ollama Tenant App Guide Troubleshooting Updating
Clone
1
Updating
daniel edited this page 2026-01-10 03:27:59 +00:00
Table of Contents

Updating GT AI OS

When a new version is available, follow the steps for your platform to update your installation.

Table of Contents

Ubuntu Linux 24.04 (x86_64)

  1. Open Terminal
  2. Go to your GT AI OS folder:
cd ~/gt-ai-os-community
  1. Download the latest version:
git pull
  1. Apply the update:
./scripts/deploy.sh
  1. Wait for the update to complete

NVIDIA DGX OS 7 (Grace Blackwell Architecture)

  1. Open Terminal
  2. Go to your GT AI OS folder:
cd ~/gt-ai-os-community
  1. Download the latest version:
git pull
  1. Apply the update:
sudo ./scripts/deploy.sh
  1. Wait for the update to complete

macOS (Apple Silicon M1+)

  1. Open Terminal
  2. Go to your GT AI OS folder:
cd ~/Desktop/gt-ai-os-community
  1. Download the latest version:
git pull
  1. Apply the update:
./scripts/deploy.sh
  1. Wait for the update to complete

What the Update Does

The deploy.sh script automatically:

  1. Detects your platform (Ubuntu Linux 24.04 (x86_64), NVIDIA DGX OS 7 (Grace Blackwell Architecture), or macOS (Apple Silicon M1+))
  2. Pulls the latest container images
  3. Runs any necessary database migrations
  4. Restarts services
  5. Verifies all services are healthy

Troubleshooting Updates

"git pull" shows conflicts

If you've modified any files locally:

git stash
git pull
git stash pop

Update seems stuck

Check the logs:

docker compose logs -f

Press Ctrl+C to stop viewing logs.

Services won't start after update

Try a clean restart:

docker compose down
docker compose up -d

Wait 2-3 minutes for services to initialize.

Need to rollback

If something goes wrong, you can revert to the previous version:

git log --oneline -5  # Find the previous commit hash
git checkout <previous-commit-hash>
./scripts/deploy.sh

Checking Your Version

To see which version you're running:

  1. Open the Tenant App: http://localhost:3002
  2. Look at the bottom of the sidebar for the version number

Or check via command line:

git describe --tags --always