proxmox/docs/04-configuration/SSH_SETUP.md

# SSH Setup for Deployment

**Last Updated:** 2026-01-31  
**Document Version:** 1.0  
**Status:** Active Documentation

---

## Issue: SSH Authentication Required

The deployment script requires SSH access to the Proxmox host. You have two options:

## Option 1: SSH Key Authentication (Recommended)

Set up SSH key to avoid password prompts:

```bash
# Generate SSH key if you don't have one
ssh-keygen -t ed25519 -C "proxmox-deployment"

# Copy key to Proxmox host
ssh-copy-id root@192.168.11.10

# Test connection (should not prompt for password)
ssh root@192.168.11.10 "echo 'SSH key working'"
```

## Option 2: Password Authentication

If you prefer to use password:

1. The script will prompt for password when needed
2. You'll need to enter it for:
   - `scp` (copying files)
   - `ssh` (running deployment)

**Note:** Password prompts may appear multiple times.

## Quick Setup SSH Key

```bash
# One-liner to set up SSH key
ssh-keygen -t ed25519 -f ~/.ssh/id_ed25519_proxmox -N "" && \
ssh-copy-id -i ~/.ssh/id_ed25519_proxmox root@192.168.11.10
```

Then add to your SSH config:

```bash
cat >> ~/.ssh/config << EOF
Host ml110
    HostName 192.168.11.10
    User root
    IdentityFile ~/.ssh/id_ed25519_proxmox
EOF
```

Then you can use:
```bash
ssh ml110
```

## Troubleshooting

### "Permission denied (publickey,password)"
- Check if password is correct
- Set up SSH key (Option 1 above)
- Verify SSH service is running on Proxmox host

### "Host key verification failed"
- Already fixed in the script
- Script automatically handles host key changes

### "Connection refused"
- Check if SSH service is running: `systemctl status ssh` (on Proxmox host)
- Verify firewall allows SSH (port 22)
- Check network connectivity: `ping 192.168.11.10`

## After SSH Key Setup

Once SSH key is configured, the deployment script will run without password prompts:

```bash
./scripts/deploy-to-proxmox-host.sh
```