For Team

SSH setup (Windows)

How to connect to ValinorPC from a Windows machine. You'll generate an SSH key, install Cloudflare's tunnel client, and configure your terminal. The whole thing takes about five minutes.

Step 1: Generate your SSH key

Open PowerShell and run:

ssh-keygen -t ed25519 -C "[email protected]"

Hit Enter through all the prompts (default location, no passphrase is fine).

Step 2: Copy your public key and send it to Carlyn

Get-Content ~\.ssh\id_ed25519.pub

This prints one long line starting with ssh-ed25519. Copy the whole thing and send it to Carlyn via Slack or email. This is the public half, safe to share openly.

Step 3: Install cloudflared

winget install Cloudflare.cloudflared

Close and reopen PowerShell after the install finishes. Verify it worked:

cloudflared --version

If winget isn't available, install it from the Microsoft Store (search "App Installer") and try again.

Step 4: Set up your SSH config

if (!(Test-Path ~\.ssh)) { New-Item -ItemType Directory -Path ~\.ssh }
Add-Content ~\.ssh\config @"

Host valinor
  HostName ssh.valinorinfo.com
  User valinor
  ProxyCommand cloudflared access ssh --hostname %h
"@

If you already have an SSH config file with other entries, this appends without overwriting anything.

Step 5: Connect

Carlyn needs to add your key on ValinorPC before this will work. Wait for her to confirm, then run:

ssh valinor

A browser window will open asking you to sign in. Use your @valinordigital.com email. After you authenticate, the terminal will connect.

If it asks "Are you sure you want to continue connecting?" type yes and hit Enter.

The Cloudflare login lasts 24 hours. After that you'll get another browser prompt, same process.

Troubleshooting

Problem Fix
cloudflared: command not found Close and reopen PowerShell, or restart your machine
Browser doesn't pop up Look in the PowerShell output for a URL, copy-paste it into your browser manually
Permission denied Carlyn hasn't added your key yet, or the key didn't copy correctly. Re-send her the output of Get-Content ~\.ssh\id_ed25519.pub
Connection times out after browser login Check with Carlyn that ValinorPC and the Cloudflare tunnel are running