Remove automatic deployment prompt from setup script

Changes:
- scripts/setup-homelab.sh: Remove interactive deployment prompt
  - Users must now run deploy script manually
  - Simplifies both scripts (no sudo workarounds needed)
  - Clearer two-step process: setup then deploy

- Documentation updates:
  - README.md: Updated step 3-4 with manual deployment
  - docs/getting-started.md: Removed step 6 (log out), clarified steps
  - docs/manual-setup.md: Added sudo to deploy command
  - docs/troubleshooting/COMMON-ISSUES.md: Added sudo to all deploy commands

Rationale:
- Automatic deployment via 'su -' cannot work with sudo requirement
- Manual two-step process is clearer and more reliable
- Setup focuses on configuration, deploy focuses on services
This commit is contained in:
2026-01-14 02:04:56 -05:00
parent ff454d35c6
commit 3e53cc3225
5 changed files with 17 additions and 48 deletions

View File

@@ -67,13 +67,11 @@ For most users, the automated setup script handles everything:
- Set up Docker networks (homelab, traefik, dockerproxy, media)
- Detect NVIDIA GPU and offer driver installation
6. **Log out and back in** (or run `newgrp docker`)
> Don't skip this step!
Required for Docker group permissions.
**Important:** If NVIDIA drivers were installed, reboot your system now before continuing.
7. **Deploy homelab**:
6. **Deploy homelab**:
```bash
./scripts/deploy-homelab.sh
sudo ./scripts/deploy-homelab.sh
```
**The deploy script automatically:**

View File

@@ -210,7 +210,7 @@ If manual setup works, you can switch to the automated scripts for future update
```bash
# Just run the deploy script
cd ~/AI-Homelab
./scripts/deploy-homelab.sh
sudo ./scripts/deploy-homelab.sh
```
The deploy script is idempotent - it won't break existing configurations.

View File

@@ -96,7 +96,7 @@ docker compose up -d
**Solution:**
```bash
# Re-run deployment script (safe - won't affect running services)
./scripts/deploy-homelab.sh
sudo ./scripts/deploy-homelab.sh
# Or manually fix:
cd /opt/stacks/dashboards/homepage
@@ -182,7 +182,7 @@ sudo systemctl stop systemd-resolved
ls -la /opt/stacks/
# Re-run deployment to copy stacks
./scripts/deploy-homelab.sh
sudo ./scripts/deploy-homelab.sh
```
## Performance Issues
@@ -235,7 +235,7 @@ sudo ./scripts/reset-test-environment.sh
# Then re-run setup and deploy
sudo ./scripts/setup-homelab.sh
./scripts/deploy-homelab.sh
sudo ./scripts/deploy-homelab.sh
```
### Partial Reset (Single Stack)