Files and SFTP

Browse a server, upload, download, compress, and open its files from the Files app.

← All documentation

The Files tab browses a server over SFTP, or over SCP if it has no SFTP. It uses the same connection as the terminal.

The basics

  • Tap a folder to open it and a text file to open it in the editor.
  • Upload brings in files from the device; Download saves them to it.
  • Select several to move, delete or compress them. Compressing and extracting happen on the server itself.
  • Drag files between panes to copy them from one place to the other.

In the iOS Files app

In the server's sheet, Show in Files makes it appear in the Files app, under "Basalt". Any app can open and save there. For that, this device puts a key of its own on the server, without Face ID; your key is not touched. Turn it off and the key is removed from the server.

Long transfers carry on when you leave the app, with their progress in the Dynamic Island.

From other apps

To upload something from another app to a server — a photo, a PDF, some text — use the share menu and choose Basalt. Tap the server, go into the folder and tap Upload: it uploads right there, without opening Basalt. Next time that folder is under Recent, one tap away.

Only servers with Show in Files or Widgets, Shortcuts and the Watch turned on appear: those get in without Face ID. You turn it on when editing the server. Servers reached through another one are not listed here: for those, use Open in Basalt.

Open in Basalt on a file opens the app and asks which server and folder it goes to, with all your servers. There the upload shows its progress in the Dynamic Island and you can leave while it runs.

Save on this device puts it in Basalt's Received folder.