SFTP for Sublime Text 4

Calm synchronisation
between project and server.

SFTPSync is a minimal plugin for macOS and Windows: upload on save, file and folder operations, conflict protection, and a focused context menu.

macOS and Windows · Sublime Text 4 · no external libraries

01

Reliable transfer

SFTP using a password. The password does not need to live in the project file.

02

Change control

Checks for a newer server version before overwriting it.

03

Whole project

Uploads and downloads files, folders, and complete project contents.

04

Russian and English

You can switch the language of commands from the plugin context menu at any time.

Complete guide

Install and first launch

  1. Download the archive

    Click “Download plugin”. The file will appear in your Downloads folder.

  2. Unzip the archive

    Double-click SFTPSync-folder-install.zip. A folder named SFTPSync will appear next to it.

  3. Copy the plugin folder

    Right-click the SFTPSync folder and choose “Copy”.

  4. Open Sublime packages

    Switch to Sublime Text. On macOS select Sublime Text → Settings → Browse Packages… On Windows select Preferences → Browse Packages… The Packages folder will open.

  5. Paste the plugin

    In the folder that opened, right-click an empty area and choose “Paste Item”.

  6. Restart Sublime Text

    On macOS, quit Sublime Text completely with ⌘Q, then open it again. On Windows, close Sublime Text normally and open the program again.

  7. Create project settings

    Open your project folder in Sublime Text. Right-click its root → SFTPSync → Create SFTPSync settings file for this project. Fill in the file that opens and save it.

Password for one session

If you remove password or set it to null, the plugin asks on first connection. It is kept only until Sublime Text is closed.

Command language

The plugin supports Russian and English. To change the language, right-click the project folder in the Sublime Text sidebar → SFTPSync → “Смена языка / Change language”, then choose a language.

Minimal sftpsync.settings

{
  "default": {
    "host": "YOUR_SFTP_HOST",
    "username": "YOUR_SFTP_LOGIN",
    "password": null,
    "path": "/www/your-site",
    "port": 22,
    "upload_on_save": true,
    "ignore": null
  }
}

Context menu

Right-click a project, file, or folder in the sidebar. The menu can transfer the complete project, operate on selected items, browse the server, compare dates, and test the connection.

Exclusions

The ignore field accepts a regular expression. Example: "node_modules/|\.git/|\.DS_Store$". It applies to uploads and downloads.

Older servers

If you see “no matching host key type found … ssh-rsa” when connecting, you may be using an older server. Uncomment the setting below in your settings file and try connecting again. It is not needed on modern servers.

// "host_key_algorithm": "ssh-rsa",

Requirements

If OpenSSH Client is missing on Windows

Open Windows Settings → Apps → Optional features. Click “Add an optional feature”, find OpenSSH Client, click “Install”, wait for the installation to finish, and restart Sublime Text completely. Then run “Test connection” again.