Handleiding

Verbinden via SSH

Terminaltoegang tot de gehuurde Mac vanaf Windows, een Mac of Linux: een SSH-sleutel, je eerste login, bestanden overzetten, tmux en VS Code. Geen extra software nodig.

Je maakt verbinding met de gehuurde Mac via gewone SSH over onze gateway gate.bohemiansilicon.com. Je installeert niets extra en stelt niets in op het netwerk. Het instellen duurt ongeveer 10 minuten, en het eerste uur van elke huur is gratis, zodat je alles rustig kunt voorbereiden.

In onze e-mail met inloggegevens krijg je je gebruikersnaam, je poortnummer (dat eruitziet als 2201), de vingerafdruk van de Mac en voor extern bureaublad een wachtwoord. Overal waar deze handleiding GEBRUIKERSNAAM en POORT noemt, gebruik je de gegevens uit die e-mail.

Voor SSH stuur je ons alleen je publieke SSH-sleutel. Inloggen met een wachtwoord is voor SSH uitgeschakeld; je logt alleen in met de sleutel.

Windows

Windows 10 en 11 hebben de SSH-client al ingebouwd, je hoeft niets anders te installeren.

1. Een SSH-sleutel maken

We raden een aparte sleutel aan, alleen voor Bohemian Silicon. De opdrachten hieronder slaan hem op onder een eigen naam, zodat ze geen sleutel overschrijven die je al ergens anders gebruikt (bijvoorbeeld id_ed25519 voor GitHub).

1. Open PowerShell (klik op Start, typ PowerShell en open het).
2. Voer deze opdrachten uit. Als om een wachtwoordzin wordt gevraagd, typ er een en bevestig hem (tijdens het typen verschijnt er niets). De wachtwoordzin beschermt de sleutel als iemand het bestand kopieert. Je kunt hem leeg laten, maar dat is minder veilig.

mkdir -Force $HOME\.ssh | Out-Null
ssh-keygen -t ed25519 -f $HOME\.ssh\bohemian_ed25519 -C bohemian-silicon

De opdracht maakt twee bestanden. bohemian_ed25519 is je privésleutel: die blijft op je computer en deel je nooit. bohemian_ed25519.pub is de openbare sleutel: die stuur je ons. Je kunt hem gerust met een gewone e-mail versturen, want alleen ermee kan niemand inloggen.

Wil je een bestaande sleutel gebruiken? Stuur ons het .pub-bestand daarvan en gebruik in de opdrachten hieronder die bestandsnaam in plaats van bohemian_ed25519.

3. Toon de openbare sleutel:

Get-Content $HOME\.ssh\bohemian_ed25519.pub

Kopieer de hele regel die begint met ssh-ed25519.

4. Stuur ons de sleutel per e-mail. Stuur nooit het bestand zonder .pub: dat is je privésleutel, en die blijft alleen op je eigen computer.

Je typt de wachtwoordzin van de sleutel bij elke verbinding.

2. Verbinden

ssh -i $HOME\.ssh\bohemian_ed25519 -p POORT GEBRUIKERSNAAM@gate.bohemiansilicon.com

1. De eerste keer toont SSH de vingerafdruk van de Mac (ED25519 key fingerprint is SHA256:…) en vraagt Are you sure you want to continue connecting?. Vergelijk hem met de vingerafdruk in onze e-mail. Typ yes alleen als ze precies overeenkomen. Zo niet, typ no en schrijf ons.
2. Je bent ingelogd als je een regel ziet die eindigt op %. Met exit verbreek je de verbinding.

Mac

1. Een SSH-sleutel maken

We raden een aparte sleutel aan, alleen voor Bohemian Silicon. De opdrachten hieronder slaan hem op onder een eigen naam, zodat ze geen sleutel overschrijven die je al ergens anders gebruikt (bijvoorbeeld id_ed25519 voor GitHub).

1. Open Terminal (Apps → Hulpprogramma’s → Terminal).
2. Voer deze opdrachten uit. Als om een wachtwoordzin wordt gevraagd, typ er een en bevestig hem (tijdens het typen verschijnt er niets). De wachtwoordzin beschermt de sleutel als iemand het bestand kopieert. Je kunt hem leeg laten, maar dat is minder veilig.

mkdir -p ~/.ssh
ssh-keygen -t ed25519 -f ~/.ssh/bohemian_ed25519 -C bohemian-silicon

De opdracht maakt twee bestanden. bohemian_ed25519 is je privésleutel: die blijft op je computer en deel je nooit. bohemian_ed25519.pub is de openbare sleutel: die stuur je ons. Je kunt hem gerust met een gewone e-mail versturen, want alleen ermee kan niemand inloggen.

Wil je een bestaande sleutel gebruiken? Stuur ons het .pub-bestand daarvan en gebruik in de opdrachten hieronder die bestandsnaam in plaats van bohemian_ed25519.

3. Toon de openbare sleutel:

pbcopy < ~/.ssh/bohemian_ed25519.pub

De sleutel staat nu op het klembord; plak hem met ⌘V.

4. Stuur ons de sleutel per e-mail. Stuur nooit het bestand zonder .pub: dat is je privésleutel, en die blijft alleen op je eigen computer.

Tip: om de wachtwoordzin niet elke keer te hoeven typen, sla je hem op in de macOS-sleutelhanger:

ssh-add --apple-use-keychain ~/.ssh/bohemian_ed25519

2. Verbinden

ssh -i ~/.ssh/bohemian_ed25519 -p POORT GEBRUIKERSNAAM@gate.bohemiansilicon.com

1. De eerste keer toont SSH de vingerafdruk van de Mac (ED25519 key fingerprint is SHA256:…) en vraagt Are you sure you want to continue connecting?. Vergelijk hem met de vingerafdruk in onze e-mail. Typ yes alleen als ze precies overeenkomen. Zo niet, typ no en schrijf ons.
2. Je bent ingelogd als je een regel ziet die eindigt op %. Met exit verbreek je de verbinding.

Linux

1. Een SSH-sleutel maken

We raden een aparte sleutel aan, alleen voor Bohemian Silicon. De opdrachten hieronder slaan hem op onder een eigen naam, zodat ze geen sleutel overschrijven die je al ergens anders gebruikt (bijvoorbeeld id_ed25519 voor GitHub).

1. Open een terminal.
2. Voer deze opdrachten uit. Als om een wachtwoordzin wordt gevraagd, typ er een en bevestig hem (tijdens het typen verschijnt er niets). De wachtwoordzin beschermt de sleutel als iemand het bestand kopieert. Je kunt hem leeg laten, maar dat is minder veilig.

mkdir -p ~/.ssh
ssh-keygen -t ed25519 -f ~/.ssh/bohemian_ed25519 -C bohemian-silicon

De opdracht maakt twee bestanden. bohemian_ed25519 is je privésleutel: die blijft op je computer en deel je nooit. bohemian_ed25519.pub is de openbare sleutel: die stuur je ons. Je kunt hem gerust met een gewone e-mail versturen, want alleen ermee kan niemand inloggen.

Wil je een bestaande sleutel gebruiken? Stuur ons het .pub-bestand daarvan en gebruik in de opdrachten hieronder die bestandsnaam in plaats van bohemian_ed25519.

3. Toon de openbare sleutel:

cat ~/.ssh/bohemian_ed25519.pub

Kopieer de hele regel die begint met ssh-ed25519.

4. Stuur ons de sleutel per e-mail. Stuur nooit het bestand zonder .pub: dat is je privésleutel, en die blijft alleen op je eigen computer.

Tip: op de meeste Linux-desktops draait al een SSH-agent, zodat je de wachtwoordzin maar één keer per sessie typt:

ssh-add ~/.ssh/bohemian_ed25519

2. Verbinden

ssh -i ~/.ssh/bohemian_ed25519 -p POORT GEBRUIKERSNAAM@gate.bohemiansilicon.com

1. De eerste keer toont SSH de vingerafdruk van de Mac (ED25519 key fingerprint is SHA256:…) en vraagt Are you sure you want to continue connecting?. Vergelijk hem met de vingerafdruk in onze e-mail. Typ yes alleen als ze precies overeenkomen. Zo niet, typ no en schrijf ons.
2. Je bent ingelogd als je een regel ziet die eindigt op %. Met exit verbreek je de verbinding.

Bestanden overzetten

Voer scp uit op je eigen computer, niet op de gehuurde Mac.

Windows

scp -i $HOME\.ssh\bohemian_ed25519 -P POORT gegevens.zip GEBRUIKERSNAAM@gate.bohemiansilicon.com:~/
scp -i $HOME\.ssh\bohemian_ed25519 -P POORT GEBRUIKERSNAAM@gate.bohemiansilicon.com:~/resultaten.zip .

Mac, Linux

scp -i ~/.ssh/bohemian_ed25519 -P POORT gegevens.zip GEBRUIKERSNAAM@gate.bohemiansilicon.com:~/
scp -i ~/.ssh/bohemian_ed25519 -P POORT GEBRUIKERSNAAM@gate.bohemiansilicon.com:~/resultaten.zip .

De eerste regel uploadt een bestand naar de gehuurde Mac, de tweede downloadt een bestand naar de huidige map. Met -r kopieer je een hele map.

Langlopende taken (tmux)

Als je de terminal sluit of de verbinding wegvalt, stoppen ook de programma’s die je daarin hebt gestart. Start lange taken, zoals het downloaden van modellen of trainen, in tmux: de sessie loopt op de Mac door, ook als je de verbinding verbreekt. Start na het inloggen op de Mac een sessie:

tmux new -s work

Start daarin je taak. Om haar te laten doorlopen en de verbinding te verbreken, druk je op Ctrl+B, laat je beide toetsen los en druk je dan op D. Na een nieuwe verbinding keer je zo terug naar de sessie:

tmux attach -t work

tmux ls toont je sessies; exit binnen een sessie beëindigt haar. Alle sessies eindigen uiterlijk aan het einde van de huur, wanneer je account wordt verwijderd.

Visual Studio Code (Remote-SSH)

1. Installeer in VS Code de extensie Remote - SSH van Microsoft.
2. Druk op F1, kies Remote-SSH: Add New SSH Host… en voer deze opdracht in (hetzelfde op Windows, Mac en Linux):

ssh -i ~/.ssh/bohemian_ed25519 -p POORT GEBRUIKERSNAAM@gate.bohemiansilicon.com

3. Sla hem op in het voorgestelde SSH-configuratiebestand. Druk dan opnieuw op F1, kies Remote-SSH: Connect to Host… en het adres van de Mac. Als naar het platform wordt gevraagd, kies macOS.
4. Bij de eerste verbinding installeert VS Code zijn serverdeel in je account op de Mac; dat duurt een à twee minuten. Daarna kun je mappen op de Mac openen en de terminal ervan direct in VS Code gebruiken.

Problemen oplossen

• De verbinding verloopt of wordt geweigerd: controleer het adres gate.bohemiansilicon.com en het poortnummer na -p. Sommige bedrijfs- of hotelnetwerken blokkeren uitgaande verbindingen naar ongebruikelijke poorten; probeer een ander netwerk, bijvoorbeeld een hotspot van je telefoon, of mail ons.
• Permission denied (publickey) of een vraag om een wachtwoord: je sleutel is niet gebruikt. Maak verbinding vanaf de computer waarop je de sleutel hebt gemaakt, geef -i op met het pad naar de sleutel en controleer de gebruikersnaam.
• REMOTE HOST IDENTIFICATION HAS CHANGED: stop en maak geen verbinding. Schrijf ons eerst. We vertellen je of de Mac opnieuw is geïnstalleerd en sturen je de nieuwe vingerafdruk. Pas dan voer je ssh-keygen -R "[gate.bohemiansilicon.com]:POORT" uit en maak je opnieuw verbinding, waarbij je de nieuwe vingerafdruk controleert.

Aan het einde van de huur

Aan het einde van de huur verwijderen we je macOS-account met de thuismap en wissen we je bestanden uit gedeelde tijdelijke mappen (/tmp, /Users/Shared). Download alles wat je wilt bewaren voordat de huur afloopt. Daarna kun je de sleutel ook van je eigen computer verwijderen: de bestanden bohemian_ed25519 en bohemian_ed25519.pub in je map .ssh.

Kom je er niet uit? Schrijf naar hello@bohemiansilicon.com en voeg een schermafbeelding of de foutmelding toe. Meestal antwoorden we binnen enkele minuten.

← Alle handleidingen