Connecting via SFTP

Every Bridglet directory is a private SFTP endpoint. This page explains your credentials and walks through connecting with the four most common clients.

Your credentials

Each directory has its own set of credentials. You'll find them on the directory page in your dashboard:

Host sftp.bridglet.com
Port 2222 (not the SSH default of 22)
Username unique per directory, e.g. acme-invoices_k9x2m1
Password shown once when the directory is created

Lost the password? Open the directory in your dashboard and regenerate credentials. This issues a new username and a new password — the old pair stops working immediately, so re-share the new credentials with anyone who uploads to that directory.

FileZilla

  1. Download FileZilla Client from filezilla-project.org and open it.
  2. At the top of the window, fill in the Quickconnect bar: Host = sftp://sftp.bridglet.com (the sftp:// prefix tells FileZilla to use SFTP), Username and Password = your directory credentials, Port = 2222.
  3. Click Quickconnect.
  4. On first connect, FileZilla shows an "Unknown host key" dialog. This is normal — check "Always trust this host" and click OK.
  5. Your directory appears in the right-hand "Remote site" pane. Drag files from the left (local) pane to the right pane to upload.

Cyberduck

  1. Download Cyberduck from cyberduck.io (macOS or Windows) and open it.
  2. Click Open Connection in the toolbar.
  3. In the dropdown at the top of the dialog, choose SFTP (SSH File Transfer Protocol).
  4. Enter Server = sftp.bridglet.com, Port = 2222, and your Username and Password.
  5. Click Connect.
  6. On first connect, Cyberduck asks about an unknown fingerprint. Click Allow (optionally check "Always" first). This is normal.
  7. Drag and drop files into the window to upload.

WinSCP

  1. Download WinSCP from winscp.net (Windows only) and open it. A Login dialog appears.
  2. Make sure File protocol is set to SFTP.
  3. Enter Host name = sftp.bridglet.com, Port number = 2222, and your User name and Password.
  4. Click Save if you want to reuse the session later, then click Login.
  5. On first connect, a "Continue connecting to an unknown server?" warning appears. Click Accept. This is normal.
  6. Your directory opens in the right-hand panel. Drag files from the left panel (your PC) to the right to upload.

Command line

The sftp command ships with macOS, Linux, and Windows 10+. Connect with:

# Interactive session (will prompt for the password)
sftp -P 2222 acme-invoices_k9x2m1@sftp.bridglet.com

# Once connected:
sftp> put report.csv     # upload a file
sftp> ls                 # list files
sftp> get report.csv     # download a file
sftp> exit

Note the capital -P for the port. On first connect you'll see "The authenticity of host ... can't be established" — type yes. This is normal.

For scripted, non-interactive uploads, curl also speaks SFTP:

# Upload a file
curl -T report.csv "sftp://sftp.bridglet.com:2222/" --user "acme-invoices_k9x2m1:YOUR_PASSWORD"

# List files
curl "sftp://sftp.bridglet.com:2222/" --user "acme-invoices_k9x2m1:YOUR_PASSWORD"

Troubleshooting

Connection refused or times out

You're almost certainly connecting to the wrong port. Bridglet uses port 2222, not the SSH default of 22. Check the port field in your client (and remember -P 2222 on the command line).

Password suddenly stopped working

If anyone on your team regenerated the directory's credentials, both the old username and old password stop working immediately. Get the new credentials from the directory page and update your client's saved session.

Login rejected after several connections

Each plan allows a set number of SFTP connections per hour: 1 on Free, 10 on Starter, 60 on Pro, and 200 on Business. If you hit the limit, wait for the hour to roll over or upgrade your plan. Batch uploads into fewer sessions where you can — one connection can transfer many files.

"Unknown host key" prompt

Every SFTP client warns the first time it sees a new server. This is expected on your first connection to sftp.bridglet.com — accept/trust the key and it won't ask again. If the prompt reappears later for the same machine, contact support before accepting.