91eea2c5ff
Created: - deploy.sh: One-command deployment script - DEPLOYMENT.md: Full deployment guide Features: - Handles cleanup of old temp directories - Shallow clone for speed - Checks for dependency changes - Verifies service after restart - Clear error messages Usage on Command Center: bash /opt/arbiter-3.0/deploy.sh Or remote curl: curl -fsSL https://git.firefrostgaming.com/.../deploy.sh | bash Chronicler #69
2.5 KiB
Arbiter 3.0 Deployment Guide
Location: Command Center (63.143.34.217)
Service: arbiter-3 (systemd)
Directory: /opt/arbiter-3.0
Dashboard: https://discord-bot.firefrostgaming.com/admin
⚠️ IMPORTANT: Arbiter is NOT a Git Repo
/opt/arbiter-3.0 on Command Center is not a git repository. It's a deployment target.
Source of truth: firefrost-services repo → services/arbiter-3.0/
Why? Production servers shouldn't have git credentials or .git history. Deploy by copying files.
Quick Deploy (One Command)
On Command Center:
curl -fsSL https://git.firefrostgaming.com/firefrost-gaming/firefrost-services/raw/branch/main/services/arbiter-3.0/deploy.sh | bash
Or if deploy.sh is already on server:
bash /opt/arbiter-3.0/deploy.sh
Manual Deploy
# On Command Center
cd /tmp
rm -rf firefrost-services
git clone https://git.firefrostgaming.com/firefrost-gaming/firefrost-services.git
cp -r firefrost-services/services/arbiter-3.0/src/* /opt/arbiter-3.0/src/
systemctl restart arbiter-3
rm -rf firefrost-services
Verify Deployment
# Check service status
systemctl status arbiter-3
# Check logs
journalctl -u arbiter-3 -n 50
# Test dashboard
curl -s https://discord-bot.firefrostgaming.com/admin | head -5
Common Issues
"fatal: not a git repository"
Cause: Someone tried to git pull in /opt/arbiter-3.0
Fix: Use the deploy script or manual copy method above
"/tmp/firefrost-services already exists"
Cause: Previous deploy didn't clean up
Fix: rm -rf /tmp/firefrost-services then try again
Service fails to start
Check: journalctl -u arbiter-3 -n 50
Common causes:
- Missing .env file
- Database connection failed
- Port already in use
- Syntax error in code
Environment Variables
Required in /opt/arbiter-3.0/.env:
DATABASE_URL=postgresql://...
DISCORD_TOKEN=...
DISCORD_CLIENT_ID=...
DISCORD_CLIENT_SECRET=...
PANEL_URL=https://panel.firefrostgaming.com
PANEL_APPLICATION_KEY=...
PANEL_CLIENT_KEY=...
STRIPE_SECRET_KEY=...
STRIPE_WEBHOOK_SECRET=...
SESSION_SECRET=...
MINECRAFT_NEST_IDS=1,5
For Chroniclers
You cannot SSH to Command Center (port 22 blocked from Claude sandbox).
Workflow:
- Make changes to
firefrost-services/services/arbiter-3.0/ - Commit and push to Gitea
- Tell Michael to run:
bash /opt/arbiter-3.0/deploy.sh - Verify via dashboard or ask Michael to check logs
Fire + Frost + Foundation = Where Love Builds Legacy 🔥❄️