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.
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
- Open Tools › Connections (Servers and Clouds)… ⌘K and click New Connection, or click Add Server… in the sidebar.
- Choose SFTP / SCP (SSH).
- Fill in the Server section:
| Field | What to type |
|---|---|
| Server Address | server.example.com, an IP address, or a Host name from your ~/.ssh/config |
| Port (optional) | empty for 22 |
| User | your 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 folder | the folder that opens, such as /var/www; empty: your home folder on the server |
- 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/configfor that host (asssh -Gdoes). 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-keychainand 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.