Creating ssh keys

Configure SSH Keys for Athene (Windows 11, macOS, and Linux)

SSH keys provide secure, streamlined access to FAU Research Computing clusters without requiring repeated password or Two-Factor Authentication (2FA) prompts. Adding your public SSH key to Athene allows terminal clients and tools such as PuTTY, VS Code, and SFTP utilities to connect quickly and easily.

Step 1: Generate an SSH Key Pair on Your Computer

Windows 11, macOS, and Linux all include the built-in OpenSSH client, allowing you to use the same commands across all three operating systems:

  1. Open your command-line application:
    • Windows 11: Open Windows Terminal, PowerShell, or Command Prompt.
    • macOS / Linux: Open your Terminal application.
  2. Generate a new SSH key pair by running:
    ssh-keygen -t ed25519

    Note: If you prefer RSA, you may run ssh-keygen -t rsa -b 4096 instead.

  3. When prompted with Enter file in which to save the key, press Enter to accept the default location (~/.ssh/id_ed25519 or C:\Users\YourUsername\.ssh\id_ed25519).
  4. When prompted with Enter passphrase (empty for no passphrase), optionally enter a passphrase for added security, or press Enter twice to leave it blank.

Step 2: Copy Your Public Key to Athene

Option A: Quick Copy (macOS / Linux)

  • Run the following command (replacing FAUNetID with your FAUNet ID) and enter your password when prompted:
    ssh-copy-id FAUNetID@athene-login.hpc.fau.edu

Troubleshooting & Next Steps

  • Private Key Permissions Error (macOS / Linux): If you receive an UNPROTECTED PRIVATE KEY FILE error on your local workstation, restrict permissions on your private key by running:
    chmod 600 ~/.ssh/id_ed25519
  • Windows Users: For additional connection guidance, please visit the Connecting to HPC via SSH on Windows knowledge base article.
  • macOS and Linux Users: For additional connection guidance, please visit the Connecting to HPC via SSH on Mac/Linux knowledge base article.

 

100% helpful - 1 review