Add Updating

2026-01-10 03:27:59 +00:00
parent d1f1294234
commit 9ed84eb013
1 changed files with 163 additions and 0 deletions
--- a/Updating.md
+++ b/Updating.md
@@ -0,0 +1,163 @@
+# 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)](#ubuntu-linux-2404-x86_64)
+- [NVIDIA DGX OS 7 (Grace Blackwell Architecture)](#nvidia-dgx-os-7-grace-blackwell-architecture)
+- [macOS (Apple Silicon M1+)](#macos-apple-silicon-m1)
+- [What the Update Does](#what-the-update-does)
+- [Troubleshooting Updates](#troubleshooting-updates)
+  - ["git pull" shows conflicts](#git-pull-shows-conflicts)
+  - [Update seems stuck](#update-seems-stuck)
+  - [Services won't start after update](#services-wont-start-after-update)
+  - [Need to rollback](#need-to-rollback)
+- [Checking Your Version](#checking-your-version)
+
+---
+
+## Ubuntu Linux 24.04 (x86_64)
+
+1. Open Terminal
+2. Go to your GT AI OS folder:
+
+```bash
+cd ~/gt-ai-os-community
+```
+
+3. Download the latest version:
+
+```bash
+git pull
+```
+
+4. Apply the update:
+
+```bash
+./scripts/deploy.sh
+```
+
+5. Wait for the update to complete
+
+---
+
+## NVIDIA DGX OS 7 (Grace Blackwell Architecture)
+
+1. Open Terminal
+2. Go to your GT AI OS folder:
+
+```bash
+cd ~/gt-ai-os-community
+```
+
+3. Download the latest version:
+
+```bash
+git pull
+```
+
+4. Apply the update:
+
+```bash
+sudo ./scripts/deploy.sh
+```
+
+5. Wait for the update to complete
+
+---
+
+## macOS (Apple Silicon M1+)
+
+1. Open Terminal
+2. Go to your GT AI OS folder:
+
+```bash
+cd ~/Desktop/gt-ai-os-community
+```
+
+3. Download the latest version:
+
+```bash
+git pull
+```
+
+4. Apply the update:
+
+```bash
+./scripts/deploy.sh
+```
+
+5. 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:
+
+```bash
+git stash
+git pull
+git stash pop
+```
+
+### Update seems stuck
+
+Check the logs:
+
+```bash
+docker compose logs -f
+```
+
+Press `Ctrl+C` to stop viewing logs.
+
+### Services won't start after update
+
+Try a clean restart:
+
+```bash
+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:
+
+```bash
+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:
+
+```bash
+git describe --tags --always
+```