git cred

rin/miner/BUILD_GUIDE.md

@@ -8,6 +8,41 @@ sudo apt update
 sudo apt install build-essential autotools-dev autoconf pkg-config libcurl4-openssl-dev libjansson-dev libssl-dev libgmp-dev zlib1g-dev git automake libtool docker.io
 ```
 
+#### Git Credential Setup (Linux Users)
+If VS Code keeps asking for Git credentials, set up credential management:
+
+**Quick Setup (Linux Mint - Recommended):**
+```bash
+cd /mnt/shared/DEV/repos/d-popov.com/mines/rin/miner
+./setup-git-credentials-linux.sh
+```
+
+**Test Your Setup:**
+```bash
+./test-git-credentials-linux.sh
+```
+
+**Available Methods:**
+- ✅ **SSH Keys** - Most secure, no password prompts (recommended)
+- ✅ **GNOME Keyring** - Encrypted storage using system keyring
+- ✅ **Git Credential Cache** - Temporary credential caching
+- ✅ **Personal Access Tokens** - For custom Git servers
+- ✅ **VS Code Integration** - Built-in credential storage
+
+**For git.d-popov.com (your custom server):**
+1. **SSH Keys (Recommended):**
+   - Run setup script and choose SSH option
+   - Copy public key to git.d-popov.com
+   - Test: `ssh -T git@git.d-popov.com`
+
+2. **Personal Access Token:**
+   - Generate token in git.d-popov.com web interface
+   - Use username + token as password
+
+3. **GNOME Keyring:**
+   - Automatic encrypted storage
+   - Integrated with system credentials
+
 ### 🛠️ VS Code Integration (Recommended)
 If you're using VS Code, the project now includes pre-configured tasks for easy building:
 
@@ -140,50 +175,59 @@ Create `.devcontainer/devcontainer.json`:
 }
 ```
 
-### Option 6: Docker Desktop Remote Connection (Windows 11)
-**For Windows 11 users with Docker Desktop:**
+### Option 6: Remote Docker Access (Linux Mint)
+**For Linux Mint users accessing remote Docker:**
 
-#### Windows Setup:
-1. **Install Docker Desktop for Windows:**
-   - Download from: https://www.docker.com/products/docker-desktop
-   - Enable WSL 2 integration during installation
+#### Local Linux Setup:
+1. **Install Docker locally (optional):**
+   ```bash
+   sudo apt update
+   sudo apt install -y docker.io
+   sudo systemctl enable docker
+   sudo usermod -aG docker $USER
+   # Logout and login again, or run: newgrp docker
+   ```
 
-2. **Enable Docker Remote API:**
-   - Open Docker Desktop → Settings → General
-   - Enable "Expose daemon on tcp://localhost:2375 without TLS"
+2. **SSH Setup:**
+   - SSH is built-in on Linux Mint
+   - Generate SSH key if needed: `ssh-keygen -t ed25519`
 
-3. **Install OpenSSH Client:**
-   - Windows 11 has OpenSSH built-in
-   - Enable in: Settings → Apps → Optional features → OpenSSH Client
+#### SSH Port Forwarding:
+```bash
+# Forward Docker socket from remote machine
+ssh -L localhost:2375:/var/run/docker.sock user@remote-build-machine
 
-#### Windows SSH Port Forwarding:
-```cmd
-REM Command Prompt:
-ssh -L localhost:2375:/var/run/docker.sock user@build-machine-ip
+# Set environment variable
+export DOCKER_HOST=tcp://localhost:2375
 
-REM PowerShell:
-ssh -L localhost:2375:/var/run/docker.sock user@build-machine-ip
+# Test remote connection
+docker run --rm cpuminer-windows-builder echo "Remote Docker working!"
 ```
 
-#### Windows Environment Setup:
-```cmd
-REM Command Prompt:
-set DOCKER_HOST=tcp://localhost:2375
+#### Docker Contexts:
+```bash
+# Create context for remote machine
+docker context create build-server --docker "host=ssh://user@remote-build-machine"
 
-REM PowerShell:
-$env:DOCKER_HOST = "tcp://localhost:2375"
-```
-
-#### Windows Docker Contexts:
-```cmd
-REM Create context for remote Linux machine:
-docker context create build-server --docker "host=ssh://user@build-machine-ip"
-
-REM Switch to remote context:
+# Switch to remote context
 docker context use build-server
 
-REM Test remote connection:
-docker run --rm cpuminer-windows-builder echo "Windows remote Docker working!"
+# All docker commands now work remotely
+docker ps
+docker run --rm cpuminer-windows-builder echo "Remote Docker working!"
+```
+
+#### VS Code Remote Development:
+```bash
+# Install VS Code extensions:
+code --install-extension ms-vscode-remote.remote-ssh
+code --install-extension ms-vscode.vscode-docker
+
+# Connect to remote machine:
+# Ctrl+Shift+P → "Remote-SSH: Connect to Host"
+# Enter: ssh user@remote-build-machine
+
+# Use Docker extension on remote machine
 ```
 
 ### 🔒 Security Recommendations
@@ -197,33 +241,30 @@ docker run --rm cpuminer-windows-builder echo "Windows remote Docker working!"
 
 **Quick Start (Most Secure):**
 
-**For Windows 11:**
-```powershell
-# On build machine - automated setup:
-cd /mnt/shared/DEV/repos/d-popov.com/mines/rin/miner
-./setup-remote-docker.sh
-
-# On your Windows 11 machine - run setup script:
-.\setup-remote-docker-windows.bat
-
-# Or use PowerShell script:
-.\setup-remote-docker-windows.ps1
-```
-
-**For Linux/Mac:**
+**For Linux Mint (Local Development):**
 ```bash
-# On build machine - automated setup:
+# On your Linux Mint machine - automated setup:
 cd /mnt/shared/DEV/repos/d-popov.com/mines/rin/miner
 ./setup-remote-docker.sh
 
-# On your local machine:
-ssh -L localhost:2375:/var/run/docker.sock user@build-machine
+# For remote Docker access:
+ssh -L localhost:2375:/var/run/docker.sock user@remote-build-machine
 export DOCKER_HOST=tcp://localhost:2375
 docker run --rm cpuminer-windows-builder echo "Ready for remote builds!"
 ```
 
+**For Remote Docker Access:**
+```bash
+# Create Docker context for remote machine:
+docker context create build-server --docker "host=ssh://user@remote-build-machine"
+docker context use build-server
+
+# All Docker commands now work remotely:
+docker run --rm cpuminer-windows-builder echo "Remote Docker working!"
+```
+
 📖 **Detailed Instructions:**
-- **Windows 11:** See [REMOTE_DOCKER_README.md](REMOTE_DOCKER_README.md) for comprehensive setup guide
+- **Linux Mint:** See [REMOTE_DOCKER_README.md](REMOTE_DOCKER_README.md) for comprehensive setup guide
 - **All Platforms:** Check [BUILD_GUIDE.md](BUILD_GUIDE.md) for additional remote access options
 
 ### 1. Build GPU Library (ROCm/HIP)