Files

copilot-swe-agent[bot] 32974a5820 Add Bitwarden, setup script, remove redundant files, update disk requirements, and add LinuxServer preference

- Add Vaultwarden (Bitwarden) password manager to utilities.yml
  - Self-hosted password manager with web UI
  - SMTP configuration for email notifications
  - Admin token for management
  - Access at bitwarden.${DOMAIN}
  - Protected by Authelia SSO

- Create automated first-run setup script (scripts/setup-homelab.sh)
  - Installs Docker Engine and Compose V2
  - Configures user groups (sudo, docker)
  - Enables SSH for remote management
  - Detects NVIDIA GPU and provides manual driver installation instructions
  - Creates directory structure and Docker networks
  - Comprehensive instructions for post-setup deployment

- Remove redundant compose files (now in core.yml)
  - Deleted authelia.yml, duckdns.yml, gluetun.yml, traefik.yml
  - All services consolidated into unified core.yml stack
  - Eliminates confusion and duplication

- Update disk space requirements across documentation
  - Changed from "100GB+ system, 1TB+ media" to:
  - "120GB+ system drive (NVMe or SSD highly recommended)"
  - "2TB+ for media & additional disks for services like Nextcloud"
  - Updated in README.md and getting-started.md

- Add preference for LinuxServer.io images
  - Updated copilot-instructions.md
  - LinuxServer images support PUID/PGID for proper file permissions
  - Preference noted in consistency guidelines

- Update core stack documentation
  - Emphasize unified core.yml deployment
  - Add both deployment methods (cd to directory vs full path)
  - Update getting-started.md with correct deployment steps
  - Note removal of separate stack files

- Add Bitwarden environment variables to .env.example
  - BITWARDEN_ADMIN_TOKEN, SIGNUPS_ALLOWED, INVITATIONS_ALLOWED
  - SMTP configuration for email notifications
  - Generation instructions included

- Update services-reference.md
  - Add Vaultwarden to utilities section (now 7 services)
  - Update service count and access URLs

All documentation now consistent with unified core stack approach and includes all requested features.

Co-authored-by: kelinfoxy <67766943+kelinfoxy@users.noreply.github.com>

2026-01-12 03:47:53 +00:00

2.3 KiB

Raw Blame History

AI-Homelab Setup Scripts

setup-homelab.sh

Automated first-run setup script for preparing a fresh Debian installation for AI-Homelab deployment.

What It Does

System Update - Updates all system packages
Install Dependencies - Installs required packages (curl, git, etc.)
Install Docker - Adds Docker repository and installs Docker Engine with Compose V2
Configure User Groups - Adds user to sudo and docker groups
Configure SSH - Enables and starts SSH server for remote access
Detect NVIDIA GPU - Checks for NVIDIA graphics card and provides manual driver installation instructions
Create Directories - Sets up /opt/stacks, /opt/dockge, /mnt/media, /mnt/downloads
Create Docker Networks - Creates homelab-network, traefik-network, and media-network

Usage

# Download the repository
git clone https://github.com/kelinfoxy/AI-Homelab.git
cd AI-Homelab

# Make the script executable (if needed)
chmod +x scripts/setup-homelab.sh

# Run with sudo
sudo ./scripts/setup-homelab.sh

After Running

Log out and log back in for group changes to take effect
Edit .env file with your configuration
Deploy the core infrastructure stack
Deploy the infrastructure stack (includes Dockge)
Access Dockge to manage remaining stacks

NVIDIA GPU Support

If an NVIDIA GPU is detected, the script will provide instructions for manual driver installation:

Identify your GPU model from the output
Visit https://www.nvidia.com/Download/index.aspx
Download the official driver for your GPU
Run the installer: sudo bash NVIDIA-Linux-x86_64-XXX.XX.run

Install container toolkit:

sudo apt-get install -y nvidia-container-toolkit
sudo nvidia-ctk runtime configure --runtime=docker
sudo systemctl restart docker

This manual approach avoids driver conflicts that often occur with automated installation methods.

Requirements

Fresh Debian installation (Debian 11 or 12)
Root access (via sudo)
Internet connection

Tested On

Debian 11 (Bullseye)
Debian 12 (Bookworm)

Notes

The script is idempotent - safe to run multiple times
Creates directories with proper ownership
Configures Docker networks automatically
SSH is enabled for remote management
NVIDIA driver installation requires manual intervention for reliability

2.3 KiB Raw Blame History