SFTP Source

The SFTP source provides a modern, secure SSH-based interface for file ingestion. It is the recommended protocol for most modern automated workflows and secure transfers.

Why SFTP?

Single Port Architecture

Unlike traditional FTP which requires a range of dynamic ports, SFTP uses exactly one port (2222) for both commands and data. This makes it extremely firewall-friendly.

Native Encryption

Built on the SSH (Secure Shell) protocol, SFTP provides robust encryption for both credentials and data by default.

Protocol Details

Feature	Details
Standard	SSH File Transfer Protocol (SFTP)
Port	2222
Security	High (Native SSH)
Firewall Status	Easy (Single port whitelist)

Authentication

Authentication is handled via Senders. You create a Sender (user, camera, etc.) once and assign it to one or more Pipes.

Login Formats

Scoped Login: username@pipe_short_id
Use this to explicitly select which Pipe to upload to if a Sender has access to multiple pipes.

Port: 2222

Supported Operations

Rilavek's SFTP gateway supports comprehensive file management operations, making it behave like a real filesystem:

Operation	Status	Description
Upload File	Supported	Stream files directly to your S3 destination
Create Directory	Supported	Create folders/prefixes in your storage
Remove Directory	Supported	Delete empty directories
Delete File	Supported	Remove files from storage
Rename / Move	Supported	Rename or move files within storage
List Directory	Supported	Browse files and folders
File Stat	Supported	Get file size, type, and modification time
Download File	Not Supported	Ingestion gateway only (upload-only by design)

Note: Downloads are intentionally disabled. Rilavek is designed as a secure ingestion gateway, not a general-purpose file server. This prevents data exfiltration through the SFTP endpoint.

Getting Started

$ sftp -P 2222 camera_01@[email protected]

Note: Most modern software (Cyberduck, WinSCP, FileZilla) supports SFTP natively. Ensure you choose "SFTP" as the protocol and port 2222.

Documentation