dosya.dev with SFTP.

Upload, download, and manage your files using any SFTP client. Works with FileZilla, WinSCP, Cyberduck, and the command line.

Get API Key

Dashboard → Settings → API Keys

Connect

sftp -P 2222 you@example.com@sftp.dosya.dev

Transfer

put file.pdf / get file.pdf

Connect from the terminal

Use your dosya.dev API key as the password. Use your dosya.dev email as the username. Get your key from the dashboard settings.

Terminal

# Connect with the sftp command
$ sftp -P 2222 you@example.com@sftp.dosya.dev
you@example.com@sftp.dosya.dev's password: dos_your_api_key
Connected to sftp.dosya.dev.
sftp>

# Username must be your dosya.dev email
$ sftp -P 2222 you@example.com@sftp.dosya.dev

~/.ssh/config

# ~/.ssh/config (optional, saves typing)
Host dosya
    HostName sftp.dosya.dev
    Port 2222
    User you@example.com

# Then simply:
$ sftp dosya
you@example.com@sftp.dosya.dev's password: dos_your_api_key
Connected to dosya.

Read the guide SFTP vs FTPS vs FTP: which should you use? Three protocols with confusingly similar names and very different properties. Here is what separates them and how to choose without guessing. 5 min read.

Use your favorite SFTP client

Connect with FileZilla, WinSCP, Cyberduck, Transmit, or any SFTP-compatible client using the settings below.

FileZilla

Windows, macOS, Linux

WinSCP

Windows

Cyberduck

Windows, macOS

Transmit

macOS

Connection Settings

Protocol:   SFTP - SSH File Transfer Protocol
Host:       sftp.dosya.dev
Port:       2222
Logon Type: Normal
User:       you@example.com  (your dosya.dev email)
Password:   dos_your_api_key

Supported operations

All standard SFTP operations are supported. Files are stored in your dosya.dev workspace with full versioning, permissions, and activity logging.

put

Upload files to your workspace. Large files (50 MB+) are automatically chunked into multipart uploads.

get

Download files from your workspace directly to your local machine.

ls / dir

List files and folders with sizes, permissions, and modification dates.

mkdir

Create new folders within your workspace.

rm / rmdir

Delete files (soft-delete to trash) and remove folders.

rename / mv

Rename files and folders, or move them to a different directory.

mput / mget

Upload or download multiple files at once with wildcard patterns.

Versioning

Uploading a file with the same name creates a new version. Previous versions are preserved.

Activity Logging

All operations are logged in your workspace activity feed for full audit trails.

Browse your workspaces

The root directory lists all workspaces you have access to. Navigate into any workspace to browse its files and folders.

sftp session

# List your workspaces (root directory)
sftp> ls
My Workspace
Team Project

# Enter a workspace
sftp> cd "My Workspace"

# List files and folders
sftp> ls -la
drwxr-xr-x    1 dosya    dosya        4096 Apr 15 10:30 Documents
drwxr-xr-x    1 dosya    dosya        4096 Apr 12 08:15 Assets
-rw-r--r--    1 dosya    dosya    47185920 Apr 14 09:15 brand-guide.pdf
-rw-r--r--    1 dosya    dosya     2097152 Apr 10 14:20 logo.png

# Navigate into folders
sftp> cd Documents
sftp> ls
report-q1.pdf    notes.txt    meeting-slides.pptx

Upload files

Files under 50 MB are uploaded in a single request. Larger files are automatically split into 10 MB chunks. Uploading to an existing filename creates a new version.

sftp put

# Upload a single file
sftp> put ~/Documents/report.pdf
Uploading ~/Documents/report.pdf to /My Workspace/report.pdf
report.pdf                              100%   45MB  12.5MB/s   00:03

# Upload to a specific folder
sftp> put ~/render-final.mp4 "My Workspace/Assets/render-final.mp4"

# Upload multiple files
sftp> mput *.pdf

# Overwriting an existing file creates a new version automatically
sftp> put report-v2.pdf report.pdf
# Version 2 created - previous version is preserved

Read the guide Back up a Linux server to object storage with cron A backup script takes ten minutes. A backup you can actually restore from takes more thought. Here is a setup with the failure modes handled. 4 min read.

Download files

Download individual files or use mget with wildcards to download multiple files at once.

sftp get

# Download a file
sftp> get brand-guide.pdf
Fetching /My Workspace/brand-guide.pdf to brand-guide.pdf
brand-guide.pdf                         100%   45MB  15.2MB/s   00:02

# Download to a specific local path
sftp> get brand-guide.pdf ~/Downloads/brand-guide.pdf

# Download multiple files
sftp> mget *.pdf

Manage files and folders

Create, rename, move, and delete files and folders. Delete operations use soft-delete — files go to trash first.

sftp mkdir / rename / rm

# Create a folder
sftp> mkdir "New Folder"

# Rename a file
sftp> rename old-name.pdf new-name.pdf

# Move a file to another folder
sftp> rename report.pdf Documents/report.pdf

# Delete a file
sftp> rm draft.txt

# Delete a folder (and its contents)
sftp> rmdir old-folder

Connection reference

Connection details

`Host`	sftp.dosya.dev
`Port`	2222
`Protocol`	SFTP (SSH File Transfer Protocol)
`Username`	Your dosya.dev email address
`Password`	Your dosya.dev API key (dos_xxxxx)

Directory structure

`/`	Lists all workspaces you have access to
`/{workspace}/`	Root of a workspace - shows top-level files and folders
`/{workspace}/folder/`	Contents of a folder within the workspace
`/{workspace}/file.txt`	A file - download with get, overwrite with put

API key scopes

`full`	Full access - upload, download, delete, rename, move
`read`	Read-only - browse and download files only
`upload`	Upload-only - upload new files but cannot download or delete

Limitations

Symlinks	Not supported - dosya.dev does not have symbolic links
chmod / chown	No-op - file permissions are managed through workspace roles
Workspace creation	Cannot create workspaces via SFTP - use the web dashboard
Transport	SFTP runs over SSH on port 2222, not over TLS. Claims elsewhere about our minimum TLS version apply to HTTPS and do not describe this connection.
Plain FTP and FTPS	Not supported. There is no FTP or FTPS listener - SFTP is a different protocol despite the similar name.
Upload scope is write-only	A credential scoped to upload can write but cannot list or download. Use read or full for anything that reads.
Max file size	No plan caps an individual file. An upload is bounded by the storage remaining in the account, and by workspace_settings.max_file_size_gb if a workspace admin has set one.