Kalgoorlie Retro Docs

Documentation for the Kalgoorlie Retro BBS, its games and servers

User Tools

Site Tools


saltbush:sftp

This is an old revision of the document!


SFTP browser and SSH agent

SFTP browser

Right-click an SSH session in the Session Manager and choose SFTP Browser…, or choose Transfer → SFTP Browser… while an SSH tab is active. The browser logs in with the built-in SSH engine; questions such as a new host key, a password or a key passphrase appear in the window, with an Answer box.

  • Double-click a folder to open it; Up goes to the parent folder; type a path and press Go to jump to it.
  • Click to select, Ctrl+click to select several.
  • Download… copies the selected files and folders to a folder you choose. Files are saved as name.part until complete.
  • Upload Files… and Upload Folder… copy to the folder shown. You can also drop files on the window.
  • New Folder…, Rename… and Delete… (Delete asks first, and deletes folders with everything in them).
  • A progress bar shows the current file; Cancel stops the transfer.

Several browser windows can be open at once. The browser cannot open sessions that need the OpenSSH client (a jump host or extra -o options); use Transfer → Open SFTP Tab… for those.

SSH agent

Tools → SSH Agent… shows the agent your sessions use and the keys it holds.

  • Add a key file: choose the private key, type its passphrase, and optionally a time to keep it (in minutes) or “ask before each use”.
  • Smartcard or token (PKCS#11): choose the card's PKCS#11 library (for example OpenSC's opensc-pkcs11.so or a YubiKey's libykcs11.so; libraries found on the computer are listed under Found), type the PIN and press Add Smartcard Keys.
  • Remove one key, or Remove All Keys.
  • Lock hides the agent's keys until Unlock is pressed with the same password.
  • Start an Agent (Linux): if no agent is running, Saltbush starts one for its sessions, local shells and scripts, and stops it when Saltbush exits.

Passphrases, PINs and lock passwords are handed to ssh-add privately, never on a command line. On Windows, start the “OpenSSH Authentication Agent” service first.

saltbush/sftp.1794240358.txt.gz · Last modified: by slaterm