Skip to main content
Rosie.run Docs

SFTP File Browser in Rosie SSH

Use Rosie SSH Files to browse, preview, upload, rename, delete, and create folders over SFTP.

Coming soon

Rosie SSH is not on the App Store yet and is not in public beta. This page describes the planned behavior.

Open Files

Rosie SSH includes an SFTP file browser for servers that expose the SFTP subsystem.

You can open Files from a saved host or from the terminal session menu. Rosie SSH authenticates to the same server using the host’s configured password or key.

What you can do

The Files view supports:

  • Browsing folders, including hidden files.
  • Searching and sorting file listings.
  • Opening folders.
  • Quick Look previews for non-text files.
  • Previewing and editing text files.
  • Uploading and downloading files.
  • Creating folders and files.
  • Renaming files and folders.
  • Deleting files and folders.
  • Sharing and exporting files.
  • Viewing and changing permissions (chmod) with Get Info.
  • Favorites and recents.
  • Multi-select for batch actions.
  • Returning to the parent folder.
  • Refreshing the current folder.

Preview and edit are intended for text files. Other files open in Quick Look.

SSH connection

SFTP reuses the active terminal SSH connection when one exists for the same host. If no active terminal connection is available, SFTP opens a separate connection as a fallback. This means:

  • When a terminal session is active, SFTP does not require additional authentication.
  • When no terminal session is active, you may see a host key prompt and a separate authentication step.
  • SFTP can fail even when the terminal works if the server disables the SFTP subsystem.

Upload and download files

To upload a file:

  1. Open Files.
  2. Tap the upload button.
  3. Choose a local file or create a new text file.
  4. Confirm the upload.

Uploads are streamed to the current remote folder.

To download a file, select it and choose the download or share action.

Permissions and errors

If a folder cannot be listed or a file cannot be changed:

  • Check the remote account’s permissions.
  • Try the parent folder.
  • Confirm the server allows SFTP.
  • Avoid unusual symlink loops or paths the server cannot normalize.

Rosie SSH does not bypass server permissions.