SFTP and SCP servers (SSH)

Mount any server you reach with ssh as a disk, with your password, a key or your SSH agent, and Folia reads your ~/.ssh/config.

Website version only

On this page

Any computer you can reach with ssh can be mounted in Folia Files: a VPS, a web server, a Raspberry Pi, a NAS with SSH turned on. Folia Files connects through rclone, which comes inside the app: there is nothing to install.

Add the server

  1. Open Tools › Connections (Servers and Clouds)… ⌘K and click New Connection, or click Add Server… in the sidebar.
  2. Choose SFTP / SCP (SSH).
  3. Fill in the Server section:
FieldWhat to type
Server Addressserver.example.com, an IP address, or a Host name from your ~/.ssh/config
Port (optional)empty for 22
Useryour login on the server (empty: the one from ~/.ssh/config)
Password (leave empty for SSH key)only if the server takes a password
Private key (optional, otherwise SSH agent)a key file; Choose… opens your ~/.ssh folder
Start folderthe folder that opens, such as /var/www; empty: your home folder on the server
  1. Click Test Connection, then Mount.

Folia Files mounts the whole server from its root: the paths are the server's own and you can go up anywhere. The start folder is only the one that opens first.

Keys, the SSH agent and ~/.ssh/config

Folia Files does what ssh would do, so a server that works in Terminal works here too:

  • It reads your ~/.ssh/config for that host (as ssh -G does). The HostName, User and Port it gives are used when the connection leaves them empty: you can type just the host's alias.
  • An IdentityAgent from the config (1Password, Secretive…) is the agent used for the connection.
  • Keys named by IdentityFile are added to your SSH agent when the config allows it (AddKeysToAgent), with their passphrase from your keychain, never asked. A key with no passphrase is read directly.
  • A key protected by a passphrase that isn't in your keychain can't be used silently: the connection's log tells you the command to type once in Terminal (ssh-add --apple-use-keychain and the key's path).
  • Your usual keys (id_ed25519, id_rsa…) are offered when the agent is empty.

Working on the server

  • Files you open are read through a cache on your Mac, so big files copy quickly and the server stays responsive during a copy.
  • A server has no live change notifications: press ⌘R (View › Refresh) to see what changed on the server from elsewhere. Changes made through Folia Files show by themselves.
  • Documents opened from the server are edited through a copy on your Mac and sent back at every save: see Editing documents on a server.

When it doesn't connect

The test and the mount explain the error in plain words: login refused, port closed, server not answering, address not found, key unreadable or protected by a passphrase, the server's key changed since last time. The connection's log has the details.