Mount storage over SSH using sshfs¶
To exchange data quickly between your laptop and our clusters, you can mount your cluster home directory on your laptop or workstation with sshfs. It then behaves like a local folder. Phoebe and Koios have separate home directories; the examples below mount your Phoebe home.
Prerequisites¶
- configured key-based authentication
- a
phoebehost entry in~/.ssh/config, as described in SSH:
Create mount aliases¶
Into your local ~/.bashrc (if you use bash), insert this snippet. Replace johndoe
with your cluster username.
phoebe_username='johndoe'
alias mount_phoebe="mkdir -p ~/phoebe_mount && sshfs -o reconnect,ServerAliveInterval=2,ServerAliveCountMax=3 phoebe:/home/${phoebe_username} ~/phoebe_mount"
alias umount_phoebe='fuser -Mk ~/phoebe_mount; fuser -Mk ~/phoebe_mount; fuser -Mk ~/phoebe_mount; fusermount -u ~/phoebe_mount'
Load the changed ~/.bashrc:
sshfs on macOS needs macFUSE and its sshfs package.
Open ~/.zshrc in your favorite editor (or create it when missing) and insert this
snippet. Replace johndoe with your cluster username.
phoebe_username='johndoe'
alias mount_phoebe="mkdir -p ~/phoebe_mount && sshfs -o reconnect,ServerAliveInterval=2,ServerAliveCountMax=3 phoebe:/home/${phoebe_username} ~/phoebe_mount"
alias umount_phoebe='umount ~/phoebe_mount'
To make sure that ~/.zshrc is loaded in every new shell, edit ~/.zprofile and insert:
Mount and unmount¶
In a new shell, type mount_phoebe to mount your cluster home directory into
~/phoebe_mount. Type umount_phoebe to unmount it.
To mount your Koios home as well, run:
mkdir -p ~/koios_mount && sshfs -o reconnect,ServerAliveInterval=2,ServerAliveCountMax=3 <username>@koios1.fzu.cz:/home/<username> ~/koios_mount
Graphical alternatives¶
If you prefer to drag and drop files, these programs talk to the clusters over SFTP, the
same SSH connection, with your SSH key. Connect to phoebe.fzu.cz or koios1.fzu.cz with
your cluster username.
- Windows: MobaXterm, which we also recommend for SSH, shows a file browser next to every SSH session. WinSCP is a dedicated file-transfer program. SFTP Net Drive (free for personal use) mounts your cluster home as a drive letter.
- macOS: Cyberduck, free.
- Linux: most file managers open SFTP addresses directly, for example
sftp://<username>@phoebe.fzu.cz/home/<username>in the address bar of GNOME Files or Dolphin.