FileOctopus Guide RoadmapProduct home

File management

Remote servers

Browse SFTP and WebDAV servers, Cloudflare R2 and S3-compatible storage in a pane: checked copies both ways, rename, delete, expiring links and Server Transfers.

Browse an SFTP or WebDAV server, or a bucket on Cloudflare R2 or other S3-compatible storage, in a pane like a folder on your Mac: open folders, copy and move files both ways, rename, make folders and delete, with every copy checked before anything is removed.

Beta. SFTP servers are new in FileOctopus 1.0.10 and are still a beta. WebDAV and S3 storage are new in 1.1.0; Amazon S3 is a beta too and says so in the Kind menu. Click Beta next to the title of the Connect to Remote Server form, or at the right of the Server Transfers title bar, and choose Send Feedback… or Discuss on Discord to tell us what works and what doesn’t. Read current limits before you copy or move files that matter.

Connect to an SFTP server

  1. Choose Go → Connect to Server… (⌘K) and type an address such as sftp://user@server.example.com. The Connect to Remote Server form opens with what you typed filled in. You can also choose Go → Connect to Remote Server (Beta)… to open it empty.
  2. Check the server, port (22 unless you change it) and user name. Leave Private key on Automatic to log in the way Terminal’s ssh does: with your keys, ssh-agent and ~/.ssh/config. Click Choose… only to use one particular key file for this server.
  3. Optionally set a Start folder and a Name for the sidebar, then connect.
  4. The first time, FileOctopus shows Trust the Server? with the server’s key fingerprint. Compare it with the one your server administrator gives you, then click Trust and Connect. If a server’s key ever changes, FileOctopus refuses to connect and shows the old and new fingerprints.
  5. If the server asks for a password, type it. Turn on Remember in Keychain to keep it in your Mac’s Keychain for next time; it is saved only after the server accepts it.

Connect to a WebDAV server

In the Connect to Remote Server form, choose WebDAV in the Kind menu, or type an address that starts with davs:// or dav:// in Go → Connect to Server…. Enter the server, keep Use HTTPS (encrypted) on unless your server only offers plain HTTP, and enter your user name. You’re asked for your password when you connect; if your account uses two-step login, use an app password. FileOctopus offers to keep the password in your Keychain only over HTTPS. WebDAV support is tested with Apache and Nextcloud.

If the server’s certificate is self-signed or from an issuer macOS doesn’t know, FileOctopus shows Trust This Certificate? with its fingerprint. Trust it only if the fingerprint matches what the server’s owner gave you. FileOctopus remembers that certificate and refuses to connect if it ever changes. A server with a self-signed certificate you trust, or plain http://, can only be reached by its IP address or its .local name; reached by another DNS name, FileOctopus says so and suggests the IP address, the .local name or a certificate from a public authority.

Connect to S3 storage

Choose the provider in the Kind menu. S3 storage needs HTTPS.

  • Cloudflare R2: enter your Account ID (the 32-character ID from the Cloudflare dashboard), the Bucket and the Access key ID.
  • S3-compatible (for example MinIO): enter the Endpoint (such as https://s3.example.com, without a path), the Bucket, the Region if your service uses one, and the Access key ID.
  • Amazon S3 (Beta): enter the Bucket, its Region and the Access key ID.

Your secret access key is asked for when you connect. Use Folder prefix to start in a folder inside the bucket. You can also type an s3:// address in Go → Connect to Server….

The server then appears under Servers in the sidebar. Click it to connect again later. FileOctopus never connects by itself when it opens, unless you turn on Connect when FileOctopus opens for that server.

Browse

A server folder works in List, Icon and Column View. The Location Bar starts with the server’s name; click any part of it to go there. A server’s row in the sidebar is selected while its start folder is shown. Open With opens a server file in the app you choose. Quick Look (Space, or Quick Look in the right-click menu) downloads a copy of the file first and asks before downloading one over 100 MB. The preview panel shows files under 100 MB by itself and offers Download for larger ones; turn off Show previews of server files in Settings → Advanced to preview only when you ask.

Copies downloaded to open or preview a server file are kept on this Mac across quitting and disconnecting, so the same file isn’t downloaded again: a kept copy is used only after the server shows the file is unchanged, and never while you are offline. Copies are kept for 14 days after their last use, up to 2 GB in all. Removing a server, or changing its address, user or bucket, removes its copies, except ones with changes not uploaded yet or open in another app. In Settings → Advanced, turn off Keep downloaded copies of server files, or click Clear Downloaded Copies… to remove them now.

After you quit, a pane that showed a server folder comes back as Not Connected with a Connect button; nothing logs in until you click it or the server in the sidebar.

Copy and move files

Drag items between a server pane and a folder on your Mac, or use Copy and Paste (⌘C, ⌘V), or ⌥⌘V to move. In Column View, Paste goes into the selected folder, as in Finder.

  • Copies to an SMB share compare names correctly when the share spells accents differently from your Mac (for example Vietnamese or French names), so verification does not fail on those files.
  • Files are written under a temporary name and get their real name only once they are complete, so a cut connection never leaves a half file under the real name.
  • Every copy is checked by size. A move is also read back and compared before its original is removed; turn on Check copies by reading them back in Settings → Advanced to read back every copy.
  • When a name already exists, you choose Keep Both, Replace or Stop. Nothing is replaced without asking.
  • Files downloaded from a server are marked as downloaded from the internet, like files from Safari.

Window → Server Transfers lists the running transfers with one progress bar each (copying and the read-back check together). Pause, resume or stop each one. The list opens by itself for longer transfers and closes when everything is done. If a transfer fails, an alert says why; when part of an upload is already on the server, Try Again continues from where it stopped.

Disconnecting while a transfer runs asks first. Stopping removes the unfinished copy; items not copied yet stay where they were.

On a WebDAV server, and within one S3 bucket, a copy from one folder to another is made by the server itself and checked, without going through your Mac. S3 storage can’t move or rename in place: a move of items stored on S3, or renaming a folder there, copies each item, checks it and then deletes the original, and FileOctopus asks before it starts because the original can’t be put back.

Rename, new items and delete

Rename (Return), New Folder (⇧⌘N) and Duplicate (⌘D) work as on your Mac; a duplicate gets Finder’s “copy” name and never replaces anything. File → New File makes an empty “untitled” file on the server. Select several items and choose Rename to rename them together with the same sheet as on your Mac; FileOctopus checks every new name on the server first and changes nothing if one is taken. Copy as Pathname (⌥⌘C) copies the server path, and Share… downloads a copy of a file and shares it.

Deleting asks first, for example Move “Old” to the server’s recycle folder?, and moves the items to a folder named .fileoctopus-trash on the server, sorted by date, where you can get them back. On a disk other than your start folder, FileOctopus uses the highest folder on that disk where it can write. Turn off Move deleted items to the server’s recycle folder in a server’s settings to delete for good; the question then says so. S3 storage has no recycle folder, so deleting there asks Delete “Old” from the server permanently? and can’t be undone; a bucket that keeps old versions is mentioned in the question. Replacing an item on S3 storage asks the same way.

Edit, disconnect and remove a server

Right-click a server in the sidebar for Connect or Disconnect, Edit Connection… and Remove…. Saving changes disconnects the server. Window → Server Log shows what happened on each connection, without passwords or file contents.

In a WebDAV or S3 folder, the right-click menu has Copy Address (hold Option for Copy Web Address) and Open in Browser. On S3 storage, Copy Expiring Link… copies a link to a file that anyone with the link can open until it expires; it doesn’t change who can see the bucket.

Free and PRO. Servers need the trial or PRO. On Free, Connect explains that it is part of FileOctopus PRO and nothing connects. See Free and PRO.

Current limits

  • WebDAV is tested with Apache and Nextcloud; other WebDAV servers may differ. S3 storage is tested with Cloudflare R2 and MinIO. Amazon S3 is a beta: it hasn’t been tested against Amazon’s own service yet.
  • Renaming several items at once isn’t available on S3 storage.
  • When a request to a server fails, the Server Log shows the chain of attempts it made. It never records passwords or tokens.
  • List and Column View show each server file’s kind icon. Icon and Gallery View show thumbnails of small images and PDFs, downloaded as you scroll.
  • Settings in your ~/.ssh/config, such as a jump host, apply as they do in Terminal.
  • Copying between two different servers goes through your Mac.
  • Compress, Make Alias and tags aren’t available for server items.
  • To drag server items into Finder or another app, use List or Icon View. From Column View they drag only within FileOctopus.

See also file operations and feature status and current limits.

Tips