SFTP on storage nodes

Per-server SFTP ingest: host/port, sftp-incoming staging, cap 50. Also needs site/env and SFTP mod gates.

SFTP on storage nodes

Members upload via SFTP into staging; a worker imports files into the catalog.

Where to find it

Admin → Servers → edit local or remote server → SFTP ingest. Members: Account → SFTP.

How it works

Field Default / limit
Enable member SFTP uploads On after remote register
SFTP public host From node public URL on connect
SFTP port 22 (1-65535)
Staging subfolder sftp-incoming
Incoming cap per user 50 (max 100000)

Files land under {storagePath}/{subpath}/{userId}/incoming/ then import. On remotes, OpenSSH + PAM are wired on Connect; auth uses website username/password.

Other gates (all must allow)

  • Env SFTP_INGEST_ENABLED (and not SFTP_INGEST_DISABLED)
  • Site sftp_ingest_site_enabled (default allow when unset)
  • Mods SFTP mod (toggle.sftp_mod, default on) and plan access

Common problems

Extra files ignored

Incoming cap is full - wait until imports free slots.

"SFTP upload is disabled on this site."

Site or mod gate is off - check Settings / Mods and env.

Test storage: staging not writable / port not reachable

Fix filesystem permissions and firewall for the SFTP port.

Related