Super Admin Troubleshooting - GT-Edge-AI/GT-AI-OS GitHub Wiki
Gen 3: This is a legacy Gen 2 article. For current GT AI OS 3.0 guidance, see gen3-admin/advanced-management.
Troubleshooting
Find solutions to common Control Panel issues. For general GT AI OS problems, see the main Troubleshooting documentation.
Overview
This guide covers:
- Login and authentication issues
- User management problems
- SMTP and email issues
- License activation problems
- Common error messages
Authentication Issues
"I forgot the login password"
Default credentials:
- Email:
[email protected] - Password:
Test@123
If you changed the password:
With SMTP configured:
- Click "Forgot Password?" on login page
- Enter your email
- Check inbox for reset link
- Set new password
Without SMTP:
- You'll need database access or a full reset
"I can't log in after deleting the default admin"
You deleted [email protected] before verifying your new account works.
Solution:
- Navigate to your GT AI OS folder:
cd ~/Desktop/GT-2.0 # Mac cd ~/GT-2.0 # Ubuntu/DGX - Reset the database:
docker compose down -v docker compose up -d - Wait 2-3 minutes
- Login with:
[email protected]/Test@123 - This time: Verify new account works BEFORE deleting default
"I'm locked out due to TFA"
You lost access to your authenticator app.
Option 1: Admin TFA Reset
If another admin has access:
- Have them reset your TFA from Users page
- Log in without TFA
- Set up TFA again
Option 2: Command Line Reset
# Reset TFA for all users
cd ~/Desktop/GT-2.0 && ./scripts/recovery/reset-tfa.sh
# Or via SQL
docker exec gentwo-controlpanel-postgres psql -U postgres -d gt2_admin -c "UPDATE users SET tfa_enabled = false, tfa_secret = NULL WHERE tfa_enabled = true;"
Option 3: Full Reset
- See "Database Reset" section below
"Session expired unexpectedly"
GT AI OS uses NIST-compliant session timeouts:
| Timeout | Duration | Behavior |
|---|---|---|
| Idle | 30 minutes | Resets with activity |
| Absolute | 12 hours | Cannot be extended |
This is by design for security. Log in again when sessions expire.
User Management Issues
"Cannot create more users"
You've reached your license seat limit.
Solutions:
- Go to Users page
- Find and disable inactive users
- Or contact GT for license upgrade
"Email already in use"
Each email must be unique across all tenants.
Solutions:
- Use a different email address
- Find and remove duplicate user first
"User can't access Control Panel"
Only Super Admin users can access the Control Panel.
Check:
- Go to Users page
- Find the user
- Verify User Type is "Super Admin"
- If not, edit and change user type
"User not receiving welcome email"
| Check | Solution |
|---|---|
| SMTP configured? | Test SMTP first |
| Welcome emails enabled? | Check Email Settings |
| Valid email address? | Verify email format |
| Spam folder? | Check junk/spam |
Email Issues
"Test email not received"
- Check spam folder - Test emails often filtered
- Verify SMTP credentials - Username and password correct
- Check from address - Must be authorized for your SMTP server
- Try different recipient - Test with another email
"Authentication failed" for SMTP
| Provider | Solution |
|---|---|
| Gmail | Use App Password from https://myaccount.google.com/apppasswords |
| Office 365 | Enable "Authenticated SMTP" in admin portal |
| Others | Verify username is full email address |
"Connection failed" for SMTP
| Check | Solution |
|---|---|
| Host correct? | Double-check SMTP host address |
| Port correct? | Try 587 (TLS) or 465 (SSL) |
| Firewall? | Ensure outbound port is open |
| TLS setting? | Toggle "Use TLS" option |
"Password reset email not sent"
- SMTP must be configured and tested first
- User must exist and be active
- Check rate limit (5 requests per email per hour)
- Verify correct email address entered
License Issues
"License activation failed"
| Cause | Solution |
|---|---|
| Incomplete content | Copy entire license string (starts with LIC-) |
| Wrong Deployment ID | License was generated for different installation |
| Corrupted | Request new license from GT |
| Expired | Request renewal license |
"Deployment ID changed"
If your Deployment ID changed (database reset, new installation):
- Copy new Deployment ID from License page
- Contact GT Edge AI support
- Request license re-issue for new ID
- Activate the new license
"License shows expired"
Contact GT Edge AI support for a renewal license.
Model and API Issues
"API key test fails"
For NVIDIA:
- Copy complete key
- Verify at https://build.nvidia.com/
For Groq:
- Key should start with
gsk_ - Verify at https://console.groq.com/
General:
- No extra spaces in key
- Try generating new key
"Models not appearing"
- Verify API key is configured and tested
- Check correct provider for model type
- Refresh page (F5)
- Restart backend:
docker compose restart control-panel-backend
Database Reset
Warning: This deletes ALL data including users, settings, and licenses.
Use only when all other options exhausted:
-
Navigate to GT AI OS folder:
cd ~/Desktop/GT-2.0 # Mac cd ~/GT-2.0 # Ubuntu/DGX -
Stop and remove everything:
docker compose down -v -
Start fresh:
docker compose up -d -
Wait 2-3 minutes
-
Login with default:
[email protected]/Test@123 -
Complete Deployment Checklist again
Debugging
View Logs
# All services
docker compose logs -f
# Control Panel backend only
docker compose logs -f control-panel-backend
# Last 100 lines
docker compose logs control-panel-backend --tail 100
Search Logs
# SMTP issues
docker compose logs control-panel-backend | grep -i smtp
# Authentication issues
docker compose logs control-panel-backend | grep -i auth
# License issues
docker compose logs control-panel-backend | grep -i license
Check Container Status
# All containers
docker compose ps
# Specific service health
docker inspect gentwo-control-panel-backend --format='{{.State.Health.Status}}'
Database Queries
# Check users
docker exec gentwo-controlpanel-postgres psql -U postgres -d gt2_admin -c "SELECT email, user_type, is_active FROM users;"
# Check license
docker exec gentwo-controlpanel-postgres psql -U postgres -d gt2_admin -c "SELECT * FROM licenses;"
# Check SMTP config (without password)
docker exec gentwo-controlpanel-postgres psql -U postgres -d gt2_admin -c "SELECT smtp_host, smtp_port, smtp_username FROM smtp_configs;"
Quick Reference
| Symptom | First Try |
|---|---|
| Can't login | Check credentials, try default |
| Forgot password | Use "Forgot Password?" (needs SMTP) |
| TFA locked | Reset TFA via command line |
| Can't create users | Check license seats |
| Email not sending | Test SMTP configuration |
| License won't activate | Verify complete string copied |
| Models missing | Check API key configuration |
Getting More Help
Check Logs First
Most issues are visible in logs:
docker compose logs control-panel-backend --tail 200
Open Support Ticket
Contact GT Edge AI support with:
- Description of the issue
- Steps to reproduce
- Error messages (from logs)
- Deployment ID (from License page)
GitHub Issues
For bug reports and feature requests: https://github.com/GT-Edge-AI/GT-AI-OS/issues
Include:
- GT AI OS version
- Platform (Mac, Ubuntu, DGX)
- Relevant log output
- Steps to reproduce