FTPMonitor / Guides / SFTP chroot permission issue

SFTP chroot permission issue

Why SFTP chroot jail permissions prevent access and how to configure directories properly.

Diagnose this automatically

Test whether the server allows directory listing with valid credentials.

terminal

npx ftpmonitor check --protocol sftp --host sftp.example.com --port 22 --username user --password pass --path /upload

Shareable output

terminal

npx ftpmonitor check --protocol sftp --host sftp.example.com --port 22 --username user --password pass --path /upload --format slack --copy

SFTP chroot environments restrict users to a specific directory.

Incorrect permissions often prevent login or directory access.

Common causes

SFTP directory listing failed — Why SFTP connects but cannot list directories, and how to fix path, permissions, and chroot issues.
ECONNREFUSED on port 22 — Meaning of ECONNREFUSED for SFTP/SSH on port 22 and the fastest ways to isolate firewall vs service vs wrong port.
SFTP connection refused — What “connection refused” means for SFTP and how to fix port/service/firewall issues quickly.
SFTP permission denied — Why SFTP returns permission denied errors and how to fix file or directory permissions.
SFTP host key verification failed — Why SSH host key verification fails and how to resolve known_hosts conflicts.
SFTP authentication failed — Why SFTP authentication fails and how to fix password or SSH key issues.